TokenLab

核心指南

遷移指南

將現有的 OpenAI、Anthropic、Gemini 和媒體客戶端遷移至 TokenLab

請保持應用程式目前使用的請求格式。OpenAI 相容客戶端、Anthropic Messages、Gemini REST 以及媒體端點均有對應的 TokenLab API 位址。

API 對應

現有 APITokenLab 基礎 URL端點注意事項
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completions對於 OpenAI 相容的聊天與函式呼叫,變動最小
OpenAI Responseshttps://api.tokenlab.sh/v1/responses當您的應用程式依賴 Responses 特定的輸入、工具或輸出處理時使用
Anthropic SDKhttps://api.tokenlab.sh/v1/messages請勿在 SDK 基礎 URL 後附加 /v1
Gemini RESThttps://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 上。

媒體遷移

  1. 查詢 GET /v1/models?recommended_for=image|video|music|3d。
  2. 從 GET /v1/models 讀取模型列表,並從 GET /v1/models/{model} 讀取詳細資訊。
  3. 發送明確的 model,特別是針對圖像端點。
  4. 為非同步作業儲存 task_id、poll_url、端點、模型以及您自己的作業 ID。使用 GET /v1/tasks/{id} 進行輪詢。
  5. 透過使用記錄與 billing_transaction_id(而非提供者作業 ID)來核對費用。

媒體生成可能會非同步完成,因此在替換現有整合之前,請務必儲存 task_id 與 poll_url。建立請求的逾時不應導致產生第二個使用者作業。

遷移陷阱

  • 如果您的應用程式需要原生的 Anthropic、Gemini 或 Responses 行為,請勿將所有模型都放在同一個 OpenAI Chat Completions 路徑下。
  • 請勿假設舊有的圖像預設值。請明確發送 model。
  • 在未檢查任務是否已建立的情況下,請勿重試非同步建立請求。
  • 在您的產品中使用 TokenLab 任務 ID 與使用記錄。第三方任務 ID 並非計費識別碼。

API 參考

主題參考
多格式 API多格式 API
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini NativeGemini Native API
圖像生成圖像生成
非同步作業與輪詢非同步作業與輪詢

本頁內容