跳到正文

协议互通矩阵

网关支持 12 种协议互译:客户端用的协议和上游用的协议可以不同,网关双向翻译请求与响应。

协议清单

协议说明
openaiOpenAI Chat Completions
openai_responseOpenAI Responses API
openai_imagesOpenAI 图像
openai_embeddingsOpenAI 向量
openai_audioOpenAI 语音(ASR/TTS)
openai_rerankOpenAI 兼容重排序
anthropicAnthropic Messages
googleGemini Generative Language
aws_converseAWS Bedrock Converse
aws_invokeAWS Bedrock InvokeModel
dashscope阿里 DashScope
passthrough透传,不翻译

互通矩阵(双向)

下列每对都是双向翻译(一个适配器同时处理 请求→ 与 响应←):

客户端协议可互译的上游协议
openaianthropicaws_invokegoogleaws_converseopenai_responsedashscope
anthropicopenai(经 chat)、aws_invokegoogleaws_converseopenai_responsedashscope
openai_responseopenai(经 chat)、aws_conversegoogledashscope
googleopenaianthropicopenai_responsedashscope
openai_embeddingsdashscope
openai_rerankdashscope
openai_audiodashscope
openai_images(图像适配器)
aws_converseopenaianthropicopenai_response
aws_invokeopenaianthropic
dashscopeopenaianthropicopenai_responsegoogleopenai_embeddingsopenai_rerankopenai_audio
passthrough任意(不翻译,原样转发)

客户端协议与上游协议相同的组合走 identity(请求体原样转发);其中 Anthropic→Anthropic 是同协议非透传翻译器(会剥离网关编码的思考签名,用于跨实例往返保持兼容)。

透传入口

  • passthrough 协议:直接转发,不做协议转换。
  • /v3/{model}/{*rest}:identity 透传入口。当客户端协议 == 该模型配置的目标协议时,请求体原样转发到上游。
  • DashScope 客户端两路:
    • /v1/services/{*rest}:透传,请求体原样发 DashScope。
    • /v1/chat/completions:翻译模式,OpenAI 格式翻译成 DashScope 格式。

无翻译器时

请求的「客户端协议 → 上游协议」组合没有翻译器 → 返回 400unsupported_feature)。

怎么用这个矩阵

  1. 确定你客户端用的协议(如 OpenAI SDK → openai)。
  2. 确定上游协议(如 Claude → anthropic)。
  3. 查上表 openai 行是否含 anthropic——含则支持互译,客户端不用改协议,网关自动翻译。
  4. 不含则要么换客户端协议,要么把上游协议改成支持的。

常见问题

Q:客户端报 400 unsupported_feature? 该「客户端协议 → 上游协议」组合没有翻译器。查本矩阵,换客户端协议或上游协议。

Q:Anthropic → Anthropic 是 identity 吗? 是同协议非透传翻译器(会剥离网关编码的思考签名,用于跨实例往返保持兼容)。其他客户端协议 == 上游协议的组合走 identity(请求体原样转发)。

Q:AWS Bedrock 客户端协议在矩阵里没看到? AWS Bedrock 是上游侧协议,不是客户端协议。客户端用 OpenAI / Anthropic / Gemini 等协议端点访问 Bedrock 模型,网关做协议互译。详见 端点 · 认证 · 协议互通

Q:怎么绕过翻译?/v3/{model}/{*rest} 透传入口,当客户端协议 == 目标协议时请求体原样转发。或上游协议选 passthrough

下一步端点 · 认证 · 协议互通 看完整端点清单;客户端接入与网关差异 看各 SDK 接法;上游与模型字段 看模型协议配置。