コアガイド
API formats
Chat Completions、Responses、Messages、またはGeminiから選択
1つのTokenLab APIキーで、4つの一般的なAPIフォーマットを利用できます。モデル固有の機能が必要な場合を除き、アプリケーションですでに使用しているフォーマットをそのままお使いください。
| フォーマット | エンドポイント | 推奨されるケース |
|---|---|---|
| Chat Completions | /v1/chat/completions | OpenAI互換のチャットクライアントを使用している、または幅広いモデル互換性を求める場合 |
| Responses | /v1/responses | アプリケーションでResponsesイベント、バックグラウンドレスポンス、またはResponsesツールを使用している場合 |
| Anthropic Messages | /v1/messages | thinkingやClaudeのツール使用など、Claude Messagesのフィールドが必要な場合 |
| Gemini | /v1beta/models/:model:generateContent | すでにGeminiの contents、parts、files、cache、またはGeminiツールを使用している場合 |
モデルページまたは GET /v1/models/{model} で tokenlab.accepted_request_formats を確認してください。すべてのモデルが4つのフォーマットすべてに対応しているとは限りません。
Chat Completions
Chat Completionsは、既存のOpenAI互換クライアントやポータブルなチャット機能にとって最も簡単な選択肢です。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKENLAB_API_KEY"],
base_url="https://api.tokenlab.sh/v1",
)
response = client.chat.completions.create(
model="gpt-5.6-luna",
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)このフォーマットは以下の場合に使用してください:
- 既存のOpenAI互換チャット統合
- 標準的なメッセージ履歴とストリーミング
- 選択したモデルでサポートされている関数呼び出し(function calling)
他のAPIフォーマット固有のフィールドは、ここでは動作が保証されません。
Responses
Responsesは、選択したモデルの accepted_request_formats に openai_responses がリストされている場合にのみ使用してください。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKENLAB_API_KEY"],
base_url="https://api.tokenlab.sh/v1",
)
response = client.responses.create(
model="gpt-5.6-terra",
input="Explain why the sky is blue in two sentences.",
)
print(response.output_text)Responses APIは、選択したモデルがサポートしている場合、作成、取得、圧縮、削除、ストリーミング、WebSocketの作成と継続、およびバックグラウンドレスポンスをサポートしています。削除は保存されたレスポンスを削除するものであり、アクティブなレスポンスをキャンセルするものではありません。
Anthropic Messages
TokenLabホストでAnthropic SDKを使用する場合は、ベースURLに /v1 を追加しないでください。
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["TOKENLAB_API_KEY"],
base_url="https://api.tokenlab.sh",
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=512,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content[0].text)Claude固有のリクエストおよびレスポンスフィールドが必要な場合は、Messagesを選択してください。Claudeのツール呼び出し、thinkingブロック、プロンプトキャッシュフィールドはこのフォーマットで保持してください。
Gemini
Geminiリクエストは、TokenLabホストとGemini RESTパスを使用します。
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "Hello!"}]}]
}'アプリケーションですでにGeminiのコンテンツパーツ、関数宣言、ファイル、キャッシュされたコンテンツ、またはその他のGeminiフィールドを使用している場合は、Geminiを選択してください。lowerCamelCaseのProtoJSON名と元のsnake_caseのproto名の両方が受け入れられますが、1つのリクエストで同じフィールドの綴りを両方送信することは避けてください。
1つの会話でフォーマットを混在させないでください
Messages、Responses、Chat Completions、Geminiは、会話の状態やツール呼び出しの扱いが異なります。1つの会話には1つのフォーマットを維持してください。保存された履歴を移行する必要がある場合は、次のリクエストを送信する前に、アプリケーション側で変換と検証を行ってください。
不明なフィールド
TokenLabは認識できないフィールドをそのまま通過させる場合がありますが、すべてのモデルがそれらを受け入れるとは限りません。機能への依存が安全と言えるのは、選択したモデルでその機能が文書化されており、かつアプリケーションがサポートされていないフィールドのエラーを適切に処理できる場合のみです。