コアガイド

移行ガイド

既存のOpenAI、Anthropic、Gemini、およびメディアクライアントをTokenLabへ移行する

アプリケーションで既に使用しているリクエスト形式を維持してください。OpenAI互換クライアント、Anthropic Messages、Gemini REST、およびメディアエンドポイントには、それぞれ対応するTokenLab APIアドレスがあります。

APIマッピング

既存のAPITokenLabベースURLエンドポイント注意点
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsOpenAI互換のチャットおよび関数呼び出しにおいて最も変更が少ない
OpenAI Responseshttps://api.tokenlab.sh/v1/responsesアプリがResponses固有の入力、ツール、または出力処理に依存している場合に使用
Anthropic SDKhttps://api.tokenlab.sh/v1/messagesSDKのベースURLに /v1 を追加しないこと
Gemini RESThttps://api.tokenlab.sh/v1beta/models/:model:generateContentGeminiネイティブのフィールドはGeminiルート上で維持すること
メディア生成https://api.tokenlab.sh/v1/images/generations, /videos/generations, /music/generations, /3d/generationsrecommended_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 上に保持してください。

メディアの移行

  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. コストの照合は、プロバイダーのタスクIDではなく、利用記録と billing_transaction_id を通じて行います。

メディア生成は非同期で完了する可能性があるため、既存の統合を置き換える前に task_id と poll_url を保存してください。作成リクエストのタイムアウトによって、ユーザーのジョブが二重に作成されないようにする必要があります。

移行の落とし穴

  • アプリがネイティブのAnthropic、Gemini、またはResponsesの動作を必要とする場合、すべてのモデルを1つのOpenAI Chat Completionsパスの背後に配置しないでください。
  • 古い画像のデフォルト設定を前提としないでください。model は明示的に送信してください。
  • タスクが既に作成されているかを確認せずに、非同期作成リクエストをリトライしないでください。
  • プロダクト内ではTokenLabのタスクIDと利用記録を使用してください。サードパーティのタスクIDは請求識別子ではありません。

APIリファレンス

トピックリファレンス
マルチフォーマットAPIマルチフォーマットAPI
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini NativeGemini Native API
画像生成画像生成
非同期ジョブとポーリング非同期ジョブとポーリング

このページの内容