协议互通矩阵
网关支持 12 种协议互译:客户端用的协议和上游用的协议可以不同,网关双向翻译请求与响应。
协议清单
| 协议 | 说明 |
|---|---|
openai | OpenAI Chat Completions |
openai_response | OpenAI Responses API |
openai_images | OpenAI 图像 |
openai_embeddings | OpenAI 向量 |
openai_audio | OpenAI 语音(ASR/TTS) |
openai_rerank | OpenAI 兼容重排序 |
anthropic | Anthropic Messages |
google | Gemini Generative Language |
aws_converse | AWS Bedrock Converse |
aws_invoke | AWS Bedrock InvokeModel |
dashscope | 阿里 DashScope |
passthrough | 透传,不翻译 |
互通矩阵(双向)
下列每对都是双向翻译(一个适配器同时处理 请求→ 与 响应←):
| 客户端协议 | 可互译的上游协议 |
|---|---|
openai | anthropic、aws_invoke、google、aws_converse、openai_response、dashscope |
anthropic | openai(经 chat)、aws_invoke、google、aws_converse、openai_response、dashscope |
openai_response | openai(经 chat)、aws_converse、google、dashscope |
google | openai、anthropic、openai_response、dashscope |
openai_embeddings | dashscope |
openai_rerank | dashscope |
openai_audio | dashscope |
openai_images | (图像适配器) |
aws_converse | openai、anthropic、openai_response |
aws_invoke | openai、anthropic |
dashscope | openai、anthropic、openai_response、google、openai_embeddings、openai_rerank、openai_audio |
passthrough | 任意(不翻译,原样转发) |
客户端协议与上游协议相同的组合走 identity(请求体原样转发);其中
Anthropic→Anthropic是同协议非透传翻译器(会剥离网关编码的思考签名,用于跨实例往返保持兼容)。
透传入口
passthrough协议:直接转发,不做协议转换。/v3/{model}/{*rest}:identity 透传入口。当客户端协议 == 该模型配置的目标协议时,请求体原样转发到上游。- DashScope 客户端两路:
/v1/services/{*rest}:透传,请求体原样发 DashScope。/v1/chat/completions:翻译模式,OpenAI 格式翻译成 DashScope 格式。
无翻译器时
请求的「客户端协议 → 上游协议」组合没有翻译器 → 返回 400(unsupported_feature)。
怎么用这个矩阵
- 确定你客户端用的协议(如 OpenAI SDK →
openai)。 - 确定上游协议(如 Claude →
anthropic)。 - 查上表
openai行是否含anthropic——含则支持互译,客户端不用改协议,网关自动翻译。 - 不含则要么换客户端协议,要么把上游协议改成支持的。
常见问题
Q:客户端报 400 unsupported_feature? 该「客户端协议 → 上游协议」组合没有翻译器。查本矩阵,换客户端协议或上游协议。
Q:Anthropic → Anthropic 是 identity 吗? 是同协议非透传翻译器(会剥离网关编码的思考签名,用于跨实例往返保持兼容)。其他客户端协议 == 上游协议的组合走 identity(请求体原样转发)。
Q:AWS Bedrock 客户端协议在矩阵里没看到? AWS Bedrock 是上游侧协议,不是客户端协议。客户端用 OpenAI / Anthropic / Gemini 等协议端点访问 Bedrock 模型,网关做协议互译。详见 端点 · 认证 · 协议互通。
Q:怎么绕过翻译? 用 /v3/{model}/{*rest} 透传入口,当客户端协议 == 目标协议时请求体原样转发。或上游协议选 passthrough。
下一步:端点 · 认证 · 协议互通 看完整端点清单;客户端接入与网关差异 看各 SDK 接法;上游与模型字段 看模型协议配置。
