✨ マルチフォーマット API

概要

TokenLab は 1 つの API キーで Chat Completions、Responses、Anthropic Messages、Gemini ネイティブの 4 つのプロトコル面を提供します。ネイティブ入口は、モデルがその形式を公開し、同一プロトコルの upstream ルートがある場合にのみ利用でき、Chat Completions へフォールバックしません。別プロトコルへ一方向にコンパイルできるのは Chat 入口だけです。

OpenAI フォーマット

/v1/chat/completions 標準フォーマット、最も幅広い互換性

Responses

/v1/responses ネイティブ Responses のライフサイクルとイベント

Anthropic フォーマット

/v1/messages Extended thinking、Claude 固有の機能

Gemini フォーマット

/v1beta/models/:model:generateContent Google エコシステムとの統合

なぜマルチフォーマットか？

利点	説明
プロトコルネイティブ SDK	その形式を公開するモデルにのみネイティブ SDK を使用し、最も広い移植面には Chat を使用します
ネイティブ機能	フォーマット固有の機能にアクセス
簡単な移行	公式 API からベース URL を変更するだけで移行可能
単一課金	1 つのアカウント、1 つの API キー、すべてのフォーマット

フォーマット比較

特徴	OpenAI	Anthropic	Gemini
Endpoint	`/v1/chat/completions`	`/v1/messages`	`/v1beta/models/:model:generateContent`
認証ヘッダー	`Authorization: Bearer`	`x-api-key`	`Authorization: Bearer`
System Prompt	`messages` 配列内	別の `system` フィールド	`systemInstruction` 内
拡張思考	❌	✅	❌
ストリーミング	✅ SSE	✅ SSE	✅ SSE
ツール呼び出し	✅	✅	✅
ビジョン	✅	✅	✅

OpenAI フォーマット

既存の OpenAI SDK 統合や、移植性のあるチャット/embedding フローには、この互換経路を使用してください。Claude または Gemini のネイティブな挙動が必要な場合は、下記の Anthropic または Gemini 形式を使用してください。

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh/v1"
)

# Portable chat works across many models
response = client.chat.completions.create(
    model="claude-sonnet-4-6",  # Claude via OpenAI format
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

適している用途：

一般的な用途
既存の OpenAI SDK 統合
最大の互換性

Anthropic フォーマット

Anthropic のネイティブ Messages API。Extended thinking のような Claude 固有の機能にはこのフォーマットが必要です。

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-tokenlab-key",
    base_url="https://api.tokenlab.sh"  # No /v1 suffix!
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    system="You are a helpful assistant.",  # Separate system field
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

拡張思考 (Claude Opus 4.6)

Anthropic フォーマットでのみ利用可能：

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    messages=[{"role": "user", "content": "Solve this complex problem..."}]
)

# Access thinking process
for block in message.content:
    if block.type == "thinking":
        print(f"Thinking: {block.thinking}")
    elif block.type == "text":
        print(f"Answer: {block.text}")

適している用途：

Claude 固有の機能
Extended thinking モード
ネイティブ Anthropic SDK ユーザー

Gemini フォーマット

Google エコシステム統合のためのネイティブな Google Gemini API フォーマットです。

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{"text": "Hello!"}]
    }],
    "systemInstruction": {
      "parts": [{"text": "You are a helpful assistant."}]
    }
  }'

ストリーミング

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:streamGenerateContent?alt=sse" \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Write a story"}]}]
  }'

適している用途：

Google Cloud 統合
既存の Gemini SDK コード
ネイティブ Gemini 機能

Gemini Files と Cache: ネイティブ Gemini ルートでは /upload/v1beta/files、/v1beta/files、/v1beta/files:register、/v1beta/cachedContents を利用できます。Files は Gemini File API 互換の上流チャネルを使い、明示的な Cache リソースは Vertex AI チャネルにもルーティングできます。TokenLab 経由で作成したリソースは同じ上流チャネル/key に束縛され、後続の generateContent でもその束縛が使われます。

ツール互換性の境界

関数ツールを一方向にコンパイルできるのは Chat 入口だけで、対象が完全なツールループを表現できる場合に限ります。プロバイダー固有のネイティブツールは、それぞれのネイティブルートに残す必要があります。

OpenAI Responses のホスト型およびネイティブツール、たとえば tool_search、web_search、file_search、code_interpreter、MCP、shell/apply_patch、computer-use ツールには /v1/responses が必要です。
Anthropic の server/native ツール、たとえば web_search_*、web_fetch_*、code_execution_*、tool_search_*、bash、computer-use、text-editor ツールには /v1/messages が必要です。
Gemini の組み込みツール、たとえば googleSearch、codeExecution、urlContext、computerUse、および同種の tools フィールドには /v1beta が必要です。

TokenLab はネイティブプロトコルのリクエストを Chat Completions へ格下げしません。未知のフィールドやツール構成は best-effort で転送され、対応可否は選択された upstream が判断します。

適切なフォーマットの選び方

マイグレーションガイド

OpenAI 公式APIから

# Before (OpenAI)
client = OpenAI(api_key="sk-openai-key")

# After (TokenLab)
client = OpenAI(
    api_key="sk-tokenlab-key",
    base_url="https://api.tokenlab.sh/v1"  # Add this line
)
# That's it! Same code works

Anthropic 公式APIから

# Before (Anthropic)
client = Anthropic(api_key="sk-ant-key")

# After (TokenLab)
client = Anthropic(
    api_key="sk-tokenlab-key",
    base_url="https://api.tokenlab.sh"  # Add this line (no /v1!)
)

Google AI Studio から

# Before (Google)
import google.generativeai as genai
genai.configure(api_key="google-api-key")

# After (TokenLab) - Use REST API
import requests

response = requests.post(
    "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:generateContent",
    headers={"Authorization": "Bearer sk-tokenlab-key"},
    json={"contents": [{"parts": [{"text": "Hello"}]}]}
)

ポータブル Chat 互換性

1 つのクライアントから異なる upstream プロトコルで提供されるモデルへ接続する場合は /v1/chat/completions を使用します。移植可能な Chat リクエストは、完全に表現できる場合に限り Responses、Messages、Gemini へ一方向にコンパイルできます。Responses、Messages、Gemini のネイティブリクエストが Chat に変換されることはなく、モデル名やプロバイダー名だけではネイティブ対応を意味しません。

Responses と Gemini の境界

現在の Responses 面は create、compact、retrieve、delete、SSE を含みます。background は HTTP のみです。WebSocket が受け付けるのは response.create だけで、stream は暗黙です。この transport では background と response.cancel を提供しません。delete は cancel ではありません。 Gemini では ProtoJSON の lowerCamelCase と proto 元来の snake_case の両方が公式で、混在リクエストもそのまま保持されます。現在の面は model list/get、generateContent、streamGenerateContent、countTokens、embedContent、batchEmbedContents を含み、Interactions と Live は含みません。未知のフィールドは best-effort で転送され、対応可否は upstream が判断します。

はじめに

コアガイド

メディアガイド

✨ マルチフォーマット API

概要

OpenAI フォーマット

Responses

Anthropic フォーマット

Gemini フォーマット

なぜマルチフォーマットか？

フォーマット比較

OpenAI フォーマット

Anthropic フォーマット

拡張思考 (Claude Opus 4.6)

Gemini フォーマット

ストリーミング

ツール互換性の境界

適切なフォーマットの選び方

マイグレーションガイド

OpenAI 公式APIから

Anthropic 公式APIから

Google AI Studio から

ポータブル Chat 互換性

Responses と Gemini の境界

​概要

OpenAI フォーマット

Responses

Anthropic フォーマット

Gemini フォーマット

​なぜマルチフォーマットか？

​フォーマット比較

​OpenAI フォーマット

​Anthropic フォーマット

​拡張思考 (Claude Opus 4.6)

​Gemini フォーマット

​ストリーミング

​ツール互換性の境界

​適切なフォーマットの選び方

​マイグレーションガイド

​OpenAI 公式APIから

​Anthropic 公式APIから

​Google AI Studio から

​ポータブル Chat 互換性

​Responses と Gemini の境界

概要

なぜマルチフォーマットか？

フォーマット比較

OpenAI フォーマット

Anthropic フォーマット

拡張思考 (Claude Opus 4.6)

Gemini フォーマット

ストリーミング

ツール互換性の境界

適切なフォーマットの選び方

マイグレーションガイド

OpenAI 公式APIから

Anthropic 公式APIから

Google AI Studio から

ポータブル Chat 互換性

Responses と Gemini の境界