コアガイド

API formats

Chat Completions、Responses、Messages、またはGeminiから選択

1つのTokenLab APIキーで、4つの一般的なAPIフォーマットを利用できます。モデル固有の機能が必要な場合を除き、アプリケーションですでに使用しているフォーマットをそのままお使いください。

フォーマットエンドポイント推奨されるケース
Chat Completions/v1/chat/completionsOpenAI互換のチャットクライアントを使用している、または幅広いモデル互換性を求める場合
Responses/v1/responsesアプリケーションでResponsesイベント、バックグラウンドレスポンス、またはResponsesツールを使用している場合
Anthropic Messages/v1/messagesthinkingや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は認識できないフィールドをそのまま通過させる場合がありますが、すべてのモデルがそれらを受け入れるとは限りません。機能への依存が安全と言えるのは、選択したモデルでその機能が文書化されており、かつアプリケーションがサポートされていないフィールドのエラーを適切に処理できる場合のみです。

関連リファレンス

このページの内容