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"}]
    }]
  }'