從 OpenAI 遷移

大多數 OpenAI 相容應用程式只需變更三項設定:

  1. 替換 API 金鑰。
  2. 將 Base URL 設為 https://getrouter.ai/v1
  3. 選擇 GetRouter 上可用的模型 ID。

Python

變更前:

from openai import OpenAI

client = OpenAI(api_key="OPENAI_API_KEY")

變更後:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "你好"}],
)

Node.js / TypeScript

變更前:

const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY })

變更後:

const client = new OpenAI({
  apiKey: process.env.GETROUTER_API_KEY,
  baseURL: 'https://getrouter.ai/v1',
})

const response = await client.chat.completions.create({
  model: 'MODEL_ID',
  messages: [{ role: 'user', content: '你好' }],
})

環境變數

如果您的應用程式會讀取標準 OpenAI 環境變數,通常只需更新執行階段設定,不必修改原始碼:

export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_BASE_URL="https://getrouter.ai/v1"

確切的環境變數名稱取決於應用程式。請確認您的 SDK 或工具支援自訂 Base URL。

檢查功能相容性

支援 OpenAI 相容的請求格式,但實際功能取決於所選模型與端點。請確認應用程式使用的功能:

  • Chat Completions 或 Responses API
  • 串流
  • 工具呼叫或函式呼叫
  • 結構化輸出
  • 視覺或其他多模態輸入
  • 嵌入、圖片或音訊
Tip

遷移時,請先傳送一個簡短的非串流請求。接著再逐一啟用串流、工具、推理與其他進階欄位。

常見遷移問題

請求傳送至原本的供應商

請確認應用程式確實讀取了自訂 Base URL。部分應用程式只會在啟動時載入環境變數。

URL 包含 /v1/v1

您的應用程式可能會自動附加 /v1。請使用該特定用戶端要求的 Base URL 格式。

模型遭到拒絕

請將原供應商的模型名稱,替換為 GetRouter Models 中完全相符的 ID。

Chat 可以使用,但 Responses 無法使用

這兩種 API 使用不同的端點與回應事件格式。請確認模型與整合支援 POST /v1/responses

後續步驟