OneMux/ドキュメント/プロトコル対応

プロトコル対応

OneMux は、OpenAI、Anthropic、Gemini、Responses API の4種類のプロトコル形式に対応しています。開発者はモデルの特性に応じて最適なプロトコルを選択でき、既存のコードを変更せずに切り替えられます。このページでは、各プロトコルのエンドポイント、認証方式、利用シーンを紹介します。

対応プロトコル

プロトコルエンドポイント対応モデル認証方式
OpenAI 互換/v1/chat/completionsすべてのモデルAuthorization: Bearer sk-xxx
Anthropic ネイティブ/v1/messagesClaude シリーズx-api-key: sk-xxx
OpenAI Responses/v1/responsesGPT シリーズAuthorization: Bearer sk-xxx
Gemini ネイティブ/v1beta/models/{model}:generateContentGemini シリーズAuthorization: Bearer sk-xxx

複数のプロトコルに対応する理由

  • 移行コストを抑制：既存のコードは変更不要で、Base URL を変更するだけで利用できます
  • ネイティブ機能に完全対応：Anthropic Prompt Caching、Claude Extended Thinking、Gemini 2M コンテキストなどの機能をサポート
  • 最高のパフォーマンス：Claude は OpenAI 形式より Anthropic プロトコルの方が 20-30% 高速です

推奨される使い方

モデル推奨プロトコル理由
Claude シリーズAnthropic ネイティブPrompt Caching に対応し、コストを 90% 削減
GPT シリーズOpenAI 互換標準形式で、互換性が最も高い
Gemini シリーズGemini ネイティブ2M コンテキストに対応し、長大なドキュメントを処理

OpenAI 互換形式

curl https://api.onemux.net/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Anthropic ネイティブ形式（Claude におすすめ）

curl https://api.onemux.net/v1/messages \
  -H "x-api-key: sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Gemini ネイティブ形式

curl https://api.onemux.net/v1beta/models/gemini-4-argon:generateContent \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "Hello"}]
    }]
  }'