IDE & SDK 互換性

概要

TokenLab は複数の API 形式を公開しているため、一般的なコーディングツール、SDK、フレームワークが最小限のグルーコードで統合可能です。このページは、マーケティング用のマトリックスよりも意図的に範囲を絞っています。

Supported (サポート済み): 具体的なセットアップ手順が文書化されており、TokenLab がその手順で期待されるプロトコル形式を公開していることを意味します。
Strong native path (強力なネイティブパス): そのリポジトリが、当該プロトコルファミリーに対する直接的なアダプターやリクエスト形式のエビデンスを備えていることを意味します。
Best-effort (ベストエフォート): 統合は機能する可能性がありますが、アップストリームのクライアントがこのカスタムゲートウェイワークフローを安定したコントラクトとして扱っていないことを意味します。

サポートされていないフィールドは一律には処理されません。互換性ルートでは、一部のフィールドは無視されるか正規化されます。/v1/responses では、リクエストされた動作を保証できない場合、サポートされていないフィールドに対して明示的な 400 または 503 エラーが返されることがあります。

サポートされている API 形式

エンドポイント	形式	ユースケース
`/v1/chat/completions`	OpenAI Chat	ユニバーサルな互換性
`/v1/responses`	OpenAI Responses	ステートフルな会話
`/v1/messages`	Anthropic Messages	Claude ネイティブ機能
`/v1beta/models/:model:generateContent`	Google Gemini	Gemini ネイティブ機能

IDE & CLI の互換性

文書化されたツールパス

ツール	サポートレベル	形式	備考
Cursor	限定的にサポート	OpenAI 互換	BYOK 標準チャット/エディタフローには対応していますが、Tab Completion のような Cursor 管理機能の代替としては機能しません
Claude Code CLI	強力なネイティブパス	Anthropic	thinking および `tool_choice` のアダプターカバレッジを備えたネイティブな `/v1/messages` ルート
Codex CLI	モデル/パス制限付きでサポート	OpenAI Responses	`/v1/responses` を Codex 特有のワークフロー向けの高度なパスとして扱ってください。Responses 専用の一部のフィールドは、すべてのモデルやルーティングパスで保証されているわけではありません
Gemini CLI	ベストエフォート / 実験的	Gemini	カスタム TokenLab ベース URL フローは、公式の Gemini CLI 統合ではありません
OpenCode	サポート済み	OpenAI 互換	デフォルトでは OpenAI 互換プロバイダーを使用してください。明示的に必要な場合にのみ Responses ベースのプロバイダーに移行してください
OpenHands	サポート済み	OpenAI 互換	`openai/<model>` と TokenLab の `/v1` ベース URL を使用して、LiteLLM/OpenAI 互換パスを使用してください

他の OpenAI 互換エディタやエージェントツールも、同じベース URL パターンで動作することがよくあります。本番環境で使用する前に、そのツール独自のカスタムプロバイダーサポートを確認してください。

設定例

Cursor
Claude Code
OpenCode
Aider

Base URL: https://api.tokenlab.sh/v1
API Key: sk-your-tokenlab-key

Cursor は内部的に Anthropic 形式のツール形式を使用します。TokenLab は両方をサポートしています：

OpenAI 形式: { type: "function", function: { name, parameters } }
Anthropic 形式: { name, input_schema } (type フィールドなし)

export ANTHROPIC_BASE_URL="https://api.tokenlab.sh"
export ANTHROPIC_API_KEY="sk-your-tokenlab-key"

export OPENAI_API_KEY="sk-your-tokenlab-key"
export LOCAL_ENDPOINT="https://api.tokenlab.sh/v1"

export OPENAI_API_KEY="sk-your-tokenlab-key"
export OPENAI_BASE_URL="https://api.tokenlab.sh/v1"
aider --model gpt-5.4

SDK の互換性

文書化された SDK & フレームワークパス

SDK / フレームワーク	言語	サポートレベル	備考
OpenAI SDK	Python/JS/Go	コアパスをサポート	`/v1` Chat Completions および Embeddings の互換パス。プロバイダー固有の動作にはネイティブプロバイダーのルートを使用し、Responses 専用フィールドがすべてのモデルで動作すると想定しないでください
Anthropic SDK	Python/JS	強力なネイティブパス	ツール、thinking、プロンプトキャッシングのエビデンスを備えたネイティブ Messages ルート
Vercel AI SDK	TypeScript	推奨される統合パターン	`@ai-sdk/openai-compatible` を優先してください。明示的に Responses ネイティブの動作が必要な場合にのみ `@ai-sdk/openai` を使用してください
LangChain	Python/JS	標準インターフェースをサポート	`ChatOpenAI` および `OpenAIEmbeddings` が対象範囲です。ベンダー固有の拡張機能は対象外です
LlamaIndex	Python	`OpenAILike` 経由でサポート	TokenLab のようなサードパーティゲートウェイには、組み込みの OpenAI クラスではなく `OpenAILike` を使用してください
OpenAI Agents SDK	Python	チャット補完パスをサポート	`OpenAIChatCompletionsModel` と共に `AsyncOpenAI(base_url="https://api.tokenlab.sh/v1")` を使用してください。ネイティブな Responses の動作は選択したモデルとルートに依存します
AutoGen	Python	カスタムエンドポイントパスをサポート	`base_url: https://api.tokenlab.sh/v1` を指定して `OpenAIChatCompletionClient` を使用してください
Semantic Kernel	.NET	カスタムエンドポイントパスをサポート	OpenAI チャット補完コネクタのカスタムエンドポイントを使用し、`https://api.tokenlab.sh/v1` を指定してください
CrewAI	Python	カスタムエンドポイントパスをサポート	`OPENAI_API_BASE` または `LLM(base_url=...)` を TokenLab の `/v1` エンドポイントに設定してください
Pydantic AI	Python	OpenAI 互換プロバイダーパスをサポート	`OpenAIProvider(base_url="https://api.tokenlab.sh/v1")` を指定して `OpenAIChatModel` を使用してください
DSPy	Python	カスタムエンドポイントパスをサポート	`dspy.LM("openai/<model>", api_base="https://api.tokenlab.sh/v1")` を使用してください
Langflow	Python / Web	範囲制限付きでサポート	OpenAI コンポーネントの OpenAI API Base フィールドに TokenLab の `/v1` エンドポイントを使用してください
Haystack	Python	カスタムエンドポイントパスをサポート	`OpenAIChatGenerator(api_base_url="https://api.tokenlab.sh/v1")` を使用してください
Graphiti	Python	カスタムエンドポイントパスをサポート	TokenLab の `/v1` エンドポイントを指定して `OpenAIGenericClient` を使用してください
Dify	-	範囲制限付きでサポート	OpenAI プロバイダーおよびチャット補完指向のフローが対象です。Codex 特有の Responses や WebSocket の動作には適していません
Flowise	Web / Node	範囲制限付きでサポート	利用可能な場合は TokenLab チャットノードを使用するか、`https://api.tokenlab.sh/v1` を指定した ChatOpenAI 互換ノードを使用してください
Mem0	Python	カスタムエンドポイントパスをサポート	OpenAI プロバイダーを維持し、`openai_base_url` を TokenLab の `/v1` エンドポイントに設定してください
Agno	Python	サポート済みパス	利用可能な場合は TokenLab モデルラッパーを使用するか、OpenAI 互換のベース URL パスを使用してください
Browser Use	Python	カスタムエンドポイントパスをサポート	TokenLab の `/v1` エンドポイントを指定して `ChatOpenAILike` を使用してください
VoltAgent	TypeScript	カスタムエンドポイントパスをサポート	`baseURL: "https://api.tokenlab.sh/v1"` で設定された AI SDK OpenAI プロバイダーを渡してください
Ragas	Python	カスタムエンドポイントパスをサポート	`AsyncOpenAI(base_url="https://api.tokenlab.sh/v1")` を `llm_factory` に渡してください
Guardrails	Python	検証パスをサポート	TokenLab の `/v1` エンドポイントで設定された OpenAI SDK チャット補完呼び出し可能オブジェクトを渡してください
Prompt flow	Python / CLI	カスタムエンドポイントパスをサポート	`base_url=https://api.tokenlab.sh/v1` を指定して OpenAI 接続を作成してください
Promptfoo	CLI / Node	サポート済みパス	`apiBaseUrl: https://api.tokenlab.sh/v1` を指定して OpenAI チャットまたは Responses プロバイダーを使用してください
Portkey Gateway	Gateway	サポート済みパス	OpenAI 互換のチャットおよび Responses トラフィックのアップストリームプロバイダーとして TokenLab を使用してください
Helicone	Gateway / Observability	可観測性パスをサポート	`Helicone-Target-Url: https://api.tokenlab.sh` を指定して、Helicone Gateway 経由で OpenAI 互換リクエストをルーティングしてください
Langfuse	Observability	トレースパスをサポート	TokenLab の `/v1` ベース URL で Langfuse OpenAI 統合を設定してください
OpenLIT	Observability	トレースパスをサポート	TokenLab の `/v1` ベース URL で設定された OpenAI SDK クライアントをインストルメントしてください
OpenLLMetry	Observability	トレースパスをサポート	TokenLab の `/v1` ベース URL で OpenAI SDK インストルメンテーションを使用してください
Phoenix	Observability	トレースパスをサポート	TokenLab の `/v1` ベース URL で設定された OpenAI SDK クライアントを自動インストルメントしてください
Opik	Observability	トレースパスをサポート	TokenLab の `/v1` ベース URL で設定された OpenAI SDK クライアントをラップしてください
LangBot	Bot Platform	チャットパスをサポート	利用可能な場合は TokenLab リクエスターを使用するか、TokenLab の `/v1` エンドポイントで OpenAI 互換リクエスターを設定してください
Open WebUI	Web Chat	チャットアプリパスをサポート	OpenAI 互換 API 接続として TokenLab を追加し、モデルリストを更新してください
Chatbox / DeepChat / Jan / LibreChat / Cherry Studio	Desktop / Web	チャットアプリパスをサポート	各アプリの OpenAI 互換カスタムプロバイダーフローを使用してください。これらのアプリは通常チャット補完指向です

Chat Completions パラメータ

コアパラメータ

パラメータ	型	説明
`model`	string	モデル識別子 (必須)
`messages`	array	会話メッセージ (必須)
`max_tokens`	integer	最大出力トークン数
`temperature`	number	サンプリング温度 (0-2)
`top_p`	number	核サンプリング (0-1)
`stream`	boolean	ストリーミングの有効化

ツール呼び出し

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get weather for a location",
        "parameters": {
          "type": "object",
          "properties": {
            "location": { "type": "string" }
          }
        },
        "strict": true
      }
    }
  ],
  "tool_choice": "auto",
  "parallel_tool_calls": true
}

ツール選択オプション

形式	例	説明
String	`"auto"`, `"none"`, `"required"`	単純な選択
OpenAI Object	`{ "type": "function", "function": { "name": "fn" } }`	特定の関数を強制
Anthropic Object	`{ "type": "tool", "name": "fn", "disable_parallel_tool_use": true }`	Anthropic ネイティブ形式

高度なパラメータ

パラメータ	型	説明
`stream_options`	object	Chat Completions のみ: `{ include_usage: true }` でトークン数を取得
`reasoning_effort`	string	推論対応 GPT-5 モデル用の `"low"`, `"medium"`, `"high"`
`service_tier`	string	`"auto"` または `"default"`
`seed`	integer	決定論的な出力
`logprobs`	boolean	ログ確率を返す
`top_logprobs`	integer	上位ログ確率の数 (0-20)
`logit_bias`	object	トークンバイアスマップ (-100 ～ 100)
`frequency_penalty`	number	繰り返しペナルティ (-2 ～ 2)
`presence_penalty`	number	トピックペナルティ (-2 ～ 2)
`stop`	string/array	停止シーケンス
`n`	integer	補完数 (1-128)
`user`	string	追跡用のユーザー識別子

OpenAI 高度な機能

パラメータ	型	説明
`modalities`	array	マルチモーダル用の `["text", "audio"]`
`audio`	object	音声出力設定 (音声、形式)
`prediction`	object	高速補完のための予測出力
`metadata`	object	追跡用のキーバリューペア
`store`	boolean	後で取得するために保存

プロバイダー固有のオプション

{
  "anthropic_options": {
    "thinking": {
      "type": "enabled",
      "budget_tokens": 10000
    },
    "prompt_caching": true
  },
  "google_options": {
    "safety_settings": [...],
    "google_search": true,
    "code_execution": true
  }
}

Anthropic Messages パラメータ

コアパラメータ

パラメータ	型	説明
`model`	string	モデル識別子
`messages`	array	会話メッセージ
`max_tokens`	integer	最大出力 (最大 128000)
`system`	string/array	システムプロンプト
`stream`	boolean	ストリーミングの有効化

ツール呼び出し

{
  "tools": [
    {
      "name": "get_weather",
      "description": "Get weather",
      "input_schema": {
        "type": "object",
        "properties": {
          "location": { "type": "string" }
        }
      }
    }
  ],
  "tool_choice": {
    "type": "auto",
    "disable_parallel_tool_use": false
  }
}

拡張 Thinking

{
  "model": "claude-opus-4-6",
  "thinking": {
    "type": "enabled",
    "budget_tokens": 10000
  }
}

Responses API パラメータ

コアパラメータ

パラメータ	型	説明
`model`	string	モデル識別子
`input`	string/array	入力コンテンツ
`instructions`	string	システム指示
`max_output_tokens`	integer	最大出力トークン数
`previous_response_id`	string	会話の継続

高度なパラメータ

パラメータ	型	説明
`truncation_strategy`	string	`"auto"` または `"disabled"`
`include`	array	`["reasoning.encrypted_content"]`
`reasoning_effort`	string	推論モデル用
`service_tier`	string	優先度ティア

ツール形式

OpenAI と Anthropic の両方のツール形式をサポートしています：

// OpenAI 形式
{ "type": "function", "name": "fn", "parameters": {...} }

// Anthropic 形式 (Cursor 互換性)
{ "name": "fn", "input_schema": {...} }

Gemini API パラメータ

コアパラメータ

パラメータ	型	説明
`contents`	array	会話コンテンツ
`systemInstruction`	object	システムプロンプト
`generationConfig`	object	生成設定

ツール

{
  "tools": [{
    "functionDeclarations": [{
      "name": "search",
      "description": "Search the web",
      "parameters": {...}
    }],
    "codeExecution": {},
    "googleSearch": {}
  }],
  "toolConfig": {
    "functionCallingConfig": {
      "mode": "AUTO"
    }
  }
}

安全設定

{
  "safetySettings": [
    {
      "category": "HARM_CATEGORY_HARASSMENT",
      "threshold": "BLOCK_MEDIUM_AND_ABOVE"
    }
  ]
}

追加パラメータ

パラメータ	型	説明
`cachedContent`	string	キャッシュされたコンテンツ参照
`responseMimeType`	string	`"text/plain"` または `"application/json"`
`responseSchema`	object	構造化出力用の JSON スキーマ

ストリーミング

Chat Completions や Responses を含む stream: true を公開する生成エンドポイントは、Server-Sent Events (SSE) を使用します：

# Chat Completions
curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -d '{"model": "gpt-4o", "messages": [...], "stream": true}'

# Chat Completions 使用状況追跡
-d '{"...", "stream_options": {"include_usage": true}}'

エラーハンドリング

TokenLab は OpenAI 互換のエラーレスポンスを返します：

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

詳細は Error Handling Guide を参照してください。

ベストプラクティス

不明なパラメータにはパススルーを使用する

不明なパラメータは、選択されたパブリックルートとモデルがそれらをサポートしている場合にのみ転送されます。

stream_options.include_usage は Chat Completions にのみ使用する

Chat Completions のストリーミングでは、正確なトークン数のために stream_options.include_usage を有効にしてください。Responses には独自のストリーミングコントラクトがあり、この Chat 専用オプションは公開されていません。

適切な tool_choice 形式を使用する

SDK が期待する形式に合わせてください。TokenLab は OpenAI 形式と Anthropic 形式の両方を受け入れます。

互換性マトリクス

コーディングツール

ネイティブ SDK

フレームワークとプラットフォーム

チャットアプリ

IDE & SDK 互換性

概要

サポートされている API 形式

IDE & CLI の互換性

文書化されたツールパス

設定例

SDK の互換性

文書化された SDK & フレームワークパス

Chat Completions パラメータ

コアパラメータ

ツール呼び出し

ツール選択オプション

高度なパラメータ

OpenAI 高度な機能

プロバイダー固有のオプション

Anthropic Messages パラメータ

コアパラメータ

ツール呼び出し

拡張 Thinking

Responses API パラメータ

コアパラメータ

高度なパラメータ

ツール形式

Gemini API パラメータ

コアパラメータ

ツール

安全設定

追加パラメータ

ストリーミング

エラーハンドリング

ベストプラクティス

​概要

​サポートされている API 形式

​IDE & CLI の互換性

​文書化されたツールパス

​設定例

​SDK の互換性

​文書化された SDK & フレームワークパス

​Chat Completions パラメータ

​コアパラメータ

​ツール呼び出し

​ツール選択オプション

​高度なパラメータ

​OpenAI 高度な機能

​プロバイダー固有のオプション

​Anthropic Messages パラメータ

​コアパラメータ

​ツール呼び出し

​拡張 Thinking

​Responses API パラメータ

​コアパラメータ

​高度なパラメータ

​ツール形式

​Gemini API パラメータ

​コアパラメータ

​ツール

​安全設定

​追加パラメータ

​ストリーミング

​エラーハンドリング

​ベストプラクティス

概要

サポートされている API 形式

IDE & CLI の互換性

文書化されたツールパス

設定例

SDK の互換性

文書化された SDK & フレームワークパス

Chat Completions パラメータ

コアパラメータ

ツール呼び出し

ツール選択オプション

高度なパラメータ

OpenAI 高度な機能

プロバイダー固有のオプション

Anthropic Messages パラメータ

コアパラメータ

ツール呼び出し

拡張 Thinking

Responses API パラメータ

コアパラメータ

高度なパラメータ

ツール形式

Gemini API パラメータ

コアパラメータ

ツール

安全設定

追加パラメータ

ストリーミング

エラーハンドリング

ベストプラクティス