核心指南
遷移指南
將現有的 OpenAI、Anthropic、Gemini 和媒體客戶端遷移至 TokenLab
請保持應用程式目前使用的請求格式。OpenAI 相容客戶端、Anthropic Messages、Gemini REST 以及媒體端點均有對應的 TokenLab API 位址。
API 對應
| 現有 API | TokenLab 基礎 URL | 端點 | 注意事項 |
|---|---|---|---|
| OpenAI Chat Completions | https://api.tokenlab.sh/v1 | /chat/completions | 對於 OpenAI 相容的聊天與函式呼叫,變動最小 |
| OpenAI Responses | https://api.tokenlab.sh/v1 | /responses | 當您的應用程式依賴 Responses 特定的輸入、工具或輸出處理時使用 |
| Anthropic SDK | https://api.tokenlab.sh | /v1/messages | 請勿在 SDK 基礎 URL 後附加 /v1 |
| Gemini REST | https://api.tokenlab.sh | /v1beta/models/:model:generateContent | 在 Gemini 路由上保留 Gemini 原生欄位 |
| 媒體生成 | https://api.tokenlab.sh/v1 | /images/generations, /videos/generations, /music/generations, /3d/generations | 使用 recommended_for 探索模型,並在有文件說明處預期非同步輪詢 |
| 管理與計費 | https://api.tokenlab.sh/v1 | /management/... | 伺服器端呼叫使用管理 token,而非模型 API key |
快速遷移方案
OpenAI 遷移至 TokenLab
將 SDK 的 base_url / baseURL 變更為 https://api.tokenlab.sh/v1,替換 API key,並從 GET /v1/models 選擇一個模型 ID。
OpenRouter 遷移至 TokenLab
將 OpenRouter 基礎 URL 替換為 https://api.tokenlab.sh/v1。TokenLab 模型 ID 不包含 OpenRouter 提供者前綴。僅在應用程式需要這些格式的欄位時,才使用 Anthropic Messages 或 Gemini。
LiteLLM 遷移至 TokenLab
使用 LiteLLM 的 custom_openai/<model> 設定,並將 api_base 設為 https://api.tokenlab.sh/v1。請將您的 LiteLLM 別名與 TokenLab 模型 ID 分開,以便在不編輯應用程式提示詞的情況下變更其中任何一個。
透過 TokenLab 使用 Claude Messages
將 Anthropic SDK 客戶端指向 https://api.tokenlab.sh 並呼叫 messages.create。請勿在 SDK 基礎 URL 後附加 /v1;SDK 本身已包含 /v1/messages 路徑。
透過 TokenLab 使用 Gemini Native
將 Gemini 負載保留在 https://api.tokenlab.sh/v1beta/models/{model}:generateContent。當您的應用程式依賴 Gemini 行為時,Gemini 原生的 contents、parts、檔案、快取內容、函式宣告與內建工具應保留在此路由上。
OpenAI 相容遷移
from openai import OpenAI
client = OpenAI(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh/v1",
)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "Hello from TokenLab"}],
)您現有的重試、逾時與串流程式碼通常可以直接使用。請使用 GET /v1/models 確認模型 ID。圖像請求必須明確包含模型;請參閱圖像指南以了解模型特定的輸入。
Anthropic 遷移
from anthropic import Anthropic
client = Anthropic(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh",
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}],
)針對 Claude 工具呼叫、思考區塊 (thinking blocks) 與 Anthropic 訊息欄位,請使用 /v1/messages。Chat Completions 不保證支援這些欄位。
Gemini 遷移
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer sk-your-tokenlab-key" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Hello"}]}]}'當您的應用程式依賴 Gemini 原生行為時,請將 Gemini 內建工具、File API 參考、快取內容、函式宣告與原生內容部分保留在 /v1beta 上。
媒體遷移
- 查詢
GET /v1/models?recommended_for=image|video|music|3d。 - 從
GET /v1/models讀取模型列表,並從GET /v1/models/{model}讀取詳細資訊。 - 發送明確的
model,特別是針對圖像端點。 - 為非同步作業儲存
task_id、poll_url、端點、模型以及您自己的作業 ID。使用GET /v1/tasks/{id}進行輪詢。 - 透過使用記錄與
billing_transaction_id(而非提供者作業 ID)來核對費用。
媒體生成可能會非同步完成,因此在替換現有整合之前,請務必儲存 task_id 與 poll_url。建立請求的逾時不應導致產生第二個使用者作業。
遷移陷阱
- 如果您的應用程式需要原生的 Anthropic、Gemini 或 Responses 行為,請勿將所有模型都放在同一個 OpenAI Chat Completions 路徑下。
- 請勿假設舊有的圖像預設值。請明確發送
model。 - 在未檢查任務是否已建立的情況下,請勿重試非同步建立請求。
- 在您的產品中使用 TokenLab 任務 ID 與使用記錄。第三方任務 ID 並非計費識別碼。
API 參考
| 主題 | 參考 |
|---|---|
| 多格式 API | 多格式 API |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| 圖像生成 | 圖像生成 |
| 非同步作業與輪詢 | 非同步作業與輪詢 |