协议与兼容范围
了解原生协议、跨协议转换、流式响应以及需要原生通道的特殊功能。
四种接入协议
- OpenAI Chat Completions：POST /v1/chat/completions
- OpenAI Responses：POST /v1/responses
- Anthropic Messages：POST /v1/messages
- Gemini：POST /v1beta/models/{model}:generateContent；流式使用 streamGenerateContent。
原生与转换
原生表示存在同协议的配置路由和启用凭据；转换表示网关可将已支持的客户端字段转为另一种上游协议，并以客户端协议返回。两者都不是健康或成功率承诺。
常用文本、图片、函数调用与结果、普通响应和 SSE 转换仍要求模型和渠道具备对应能力。无法安全转换的内容会被拒绝，不能通过忽略内容来伪装成功。
需要原生通道的功能
- Responses 的 previous_response_id、conversation、上游内置工具和加密推理内容需要原生 Responses 通道。跨协议调用应发送完整历史。
- Chat 的多候选 n > 1、Gemini 的 cachedContent／多候选，以及厂商内置工具或特殊内容块需要相应原生协议。
- 推理签名、缓存语义和厂商扩展字段不能保证跨供应商等价；真实 Agent 工作流应按实际客户端与渠道单独验证。
故障与重试
是否切换备用路由取决于恢复策略、上游拒绝证据及请求是否已经输出。已经收到生成或用量证据时，不应假定请求可以安全重发。
错误码和计费策略不等于实际扣费；请以最终请求记录、结算金额和钱包流水为准。