协议转换参数兼容性 ​

开桥支持通过不同协议调用同一批模型。本文说明跨协议转发时，常见请求参数、响应字段与流式事件如何映射，以及哪些字段在目标协议中没有等价能力。

本文参考 开桥/rosetta-ai 的协议转换实现编写。rosetta-ai 覆盖 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 与 Google Gemini 四类协议之间的 12 组双向转换。

协议简称 ​

支持总览 ​

下表从“请求来源协议”的角度阅读：例如 Chat Completions 行表示你使用 OpenAI Chat Completions 协议发起请求时，该字段可以转换到哪些后端协议。

Chat Completions 请求转换 ​

Chat Completions → Messages ​

不转换：frequency_penalty、presence_penalty、seed、n、logprobs、top_logprobs、logit_bias。

Chat Completions → Responses ​

不转换：frequency_penalty、presence_penalty、seed、n、logprobs、stop。

Chat Completions → Gemini ​

不转换：logit_bias、user。

Messages 请求转换 ​

Messages → Chat Completions ​

Document block 转换规则：

• source.type: "base64" / "url" → Chat Completions file content part
• source.type: "text" → 文本 content part
• source.type: "content" → 展开内部文本 / 图片内容块

tool_result content 转换规则：

• text 保留
• search_result 展开内部文本
• tool_reference 保留工具名
• 图片 / document 不支持放入 OpenAI tool role，会被跳过

不转换：top_k、Anthropic 专属 metadata 字段。

Messages → Responses ​

不转换：stop_sequences、top_k。

Messages → Gemini ​

不转换：metadata。

Document block 转换规则：

• source.type: "base64" → inlineData
• source.type: "url" → fileData
• source.type: "text" → text
• 其它来源 → 不支持占位文本

Responses 请求转换 ​

Responses → Chat Completions ​

不转换：previous_response_id。

Responses → Messages ​

不转换：previous_response_id、prompt_cache_key、prompt_cache_retention、safety_identifier。

Responses → Gemini ​

不转换：metadata、previous_response_id、parallel_tool_calls、prompt_cache_key、prompt_cache_retention、safety_identifier。

Gemini 请求转换 ​

Gemini → Chat Completions ​

不转换：config.safetySettings、config.cachedContent、config.responseModalities。

Gemini → Messages ​

不转换：config.seed、config.frequencyPenalty、config.presencePenalty、config.candidateCount、config.safetySettings、config.cachedContent。

Gemini → Responses ​

不转换：config.seed、config.frequencyPenalty、config.presencePenalty、config.candidateCount、config.safetySettings、config.cachedContent。

响应字段转换 ​

用量字段转换 ​

流式转换能力 ​

所有 12 组转换都支持流式输出。不同协议的事件名不同，但以下内容会尽量保留：

常见差异与注意事项 ​

• Responses 没有 stop / stop_sequences 的直接等价请求字段，从 Chat Completions 或 Messages 转到 Responses 时不会转换停止序列。
• Gemini 不支持 parallel_tool_calls、metadata、service_tier、prompt cache key 等 OpenAI / Anthropic 扩展参数。
• Anthropic Messages 的 top_k 只在转 Gemini 时保留；转 Chat Completions 或 Responses 时不会转换。
• Chat Completions 的 seed、frequency_penalty、presence_penalty、n 主要可以转 Gemini；转 Messages / Responses 时没有等价字段。
• reasoning_effort 与 thinking 的映射是区间映射，不是精确 token 上限保真；需要精确控制 thinking budget 时，优先使用目标协议的原生参数。
• 工具结果里的图片 / document 在转 Chat Completions tool role 时会被跳过，因为 OpenAI tool role 只接收文本内容。
• 协议转换会尽量保留 web search / grounding 结果，但不同协议的引用结构不同，字段名与嵌套层级会变化。