OneMux/文件中心/協定支援

協定支援

OneMux 同時支援 OpenAI、Anthropic、Gemini 和 Responses API 四種協定格式。開發者可以根據模型特性選擇最佳協定，無需修改現有程式碼即可切換。本頁列出各協定的端點、驗證方式和使用情境。

支援的協定

協定端點適用模型驗證方式
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 使用 Anthropic 協定，比 OpenAI 格式快 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"}]
    }]
  }'