コアガイド
移行ガイド
既存の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/... | サーバーサイドの呼び出しにはモデルAPIキーではなく管理トークンを使用すること |
クイック移行レシピ
OpenAIからTokenLabへ
SDKの base_url / baseURL を https://api.tokenlab.sh/v1 に変更し、APIキーを置き換え、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"}],
)既存のリトライ、タイムアウト、ストリーミングのコードは通常そのまま使用できます。モデルIDは GET /v1/models で確認してください。画像リクエストにはモデルを明示的に含める必要があります。モデル固有の入力については画像ガイドを参照してください。
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のツール呼び出し、思考ブロック、および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}でポーリングします。 - コストの照合は、プロバイダーのタスクIDではなく、利用記録と
billing_transaction_idを通じて行います。
メディア生成は非同期で完了する可能性があるため、既存の統合を置き換える前に task_id と poll_url を保存してください。作成リクエストのタイムアウトによって、ユーザーのジョブが二重に作成されないようにする必要があります。
移行の落とし穴
- アプリがネイティブのAnthropic、Gemini、またはResponsesの動作を必要とする場合、すべてのモデルを1つのOpenAI Chat Completionsパスの背後に配置しないでください。
- 古い画像のデフォルト設定を前提としないでください。
modelは明示的に送信してください。 - タスクが既に作成されているかを確認せずに、非同期作成リクエストをリトライしないでください。
- プロダクト内ではTokenLabのタスクIDと利用記録を使用してください。サードパーティのタスクIDは請求識別子ではありません。
APIリファレンス
| トピック | リファレンス |
|---|---|
| マルチフォーマットAPI | マルチフォーマットAPI |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| 画像生成 | 画像生成 |
| 非同期ジョブとポーリング | 非同期ジョブとポーリング |