兼容矩阵
60+ chat 模型 × 4 个客户端协议(OpenAI Chat / Anthropic Messages / OpenAI Responses / Gemini Native),按通道族标注原生直通 / 协议翻译 / 未支持,附 X-Protocol-Translation 自检方法
本平台对外暴露 4 个客户端协议端点,同一把 sk-gpushare-* API Key 通用:
| 协议 | 端点 | 典型客户端 |
|---|---|---|
| OpenAI Chat | POST /v1/chat/completions | OpenAI SDK、绝大多数第三方客户端 |
| Anthropic Messages | POST /v1/messages | Anthropic SDK、Claude Code |
| OpenAI Responses | POST /v1/responses | OpenAI Responses SDK、Codex CLI |
| Gemini Native | POST /v1beta/models/{model}:generateContent / :streamGenerateContent | Google genai SDK |
不是每个模型都支持全部 4 个协议。矩阵的真源是通道布线——每个模型由哪类上游通道服务、该通道声明了哪些协议——而不是「模型厂商 × 协议」的理论推导。同一通道池里的模型协议面相同,所以下面按通道族分组列出(截至 2026-07 的生产布线)。
符号说明#
| 符号 | 含义 |
|---|---|
| ✅ | 原生直通 —— 客户端协议与上游通道协议一致,网关字节级透传 |
| 🔄 | 协议翻译 —— 中间发生协议转换,分两类(见下) |
| ❔ | 有通道、未实测 —— 该协议有通道声明(不会 503),但端到端可用性未逐格实测 |
| — | 无通道 —— 返回 503 no_channel_available(注意:是 503,不是 404);标注「已知失败」的格子有通道但上游转换失败,返 5xx |
🔄 的两类,客户端可以从响应 header 区分:
- 网关侧翻译(T1 / T2,见下表):网关把请求体转成上游协议、把响应转回客户端协议,响应带
X-Protocol-Translationheader。 - 上游侧转换(标「上游转换」):网关字节级透传,协议转换发生在上游服务内部,没有
X-Protocol-Translationheader。协议形状对客户端完整,但另一协议独有的特性(如 Anthropic 的cache_control、thinking 块)不保证语义保真。
网关侧翻译路径速查#
| 路径 | 方向(客户端 → 上游) | X-Protocol-Translation 值 | 当前是否触发 |
|---|---|---|---|
| T1 | OpenAI Chat → Anthropic 上游 | openai_chat_to_anthropic_messages | ✅ 生产在用(Claude 池 / 体验池的 /v1/chat/completions 流量) |
| T2 | OpenAI Chat → Gemini 上游 | openai_chat_to_gemini_native | ✅ 生产在用(Gemini 池的 /v1/chat/completions 流量) |
| T3 | Anthropic Messages → OpenAI 上游 | anthropic_messages_to_openai_chat | 已实现,当前无通道组合触发 |
| T4 | Gemini Native → OpenAI 上游 | gemini_native_to_openai_chat | 已实现,当前无通道组合触发 |
| T6 | Gemini Native → Anthropic 上游 | anthropic_messages_to_gemini_native | 已实现,当前无通道组合触发 |
T3 / T4 / T6 是为未来通道布线预留的:今天 Anthropic Messages / Gemini Native 的跨协议流量全部由上游通道在上游侧转换承接,网关侧这三条翻译器不会被路由命中。
矩阵总览#
| 通道族 | 模型数 | OpenAI Chat | Anthropic Messages | OpenAI Responses | Gemini Native |
|---|---|---|---|---|---|
| GPT 池(X1) | 2 | ✅ | 🔄 上游转换¹ | ✅ | — |
| Claude 池(X1) | 5 | 🔄 T1 | ✅ | ✅ | — |
| Gemini 池(X1,文本) | 2 | 🔄 T2 | ❔ | ❔ | ✅ |
| Gemini 池(X1,图像) | 1 | 🔄 T2 | — | — | ✅ |
| 体验池(X1) | 6 | 🔄 T1 | ✅ | — | —² |
| 智谱 GLM(X2) | 3 | ✅ | 🔄 上游转换 | ❔ | ❔ |
| 多厂商池(X2) | 13 | ✅ | — | — | — |
| 混元 / DeepSeek 独占池(X3) | 5 | ✅ | — | — | — |
| 豆包池(X4) | 21 | ✅ | — | — | — |
| Grok 池(X1) | 8 | ✅ | — | — | — |
¹ gpt-5.x 的 /v1/messages 请求由上游在内部转换承接:网关近字节透传(仅补默认 max_tokens),无 X-Protocol-Translation header。Anthropic 独有特性(cache_control、thinking 块)不保证保真——重度依赖这些特性请改用 Claude 系模型。
² 体验池里 gemini-* 命名的模型其上游说的是 Anthropic 协议——它们反而不能用 Gemini Native 端点调用(503)。
同一格子背后可能有多条通道做 failover;矩阵标注的是主路径。
分组明细#
GPT 池(X1,2 模型)#
gpt-5.4 gpt-5.5
- OpenAI Chat ✅:带内置工具(
web_search/image_generation)的请求内部走 WS V2 通道,对外协议形状不变。 - OpenAI Responses ✅:上游原生 Responses 协议直通,是 GPT-5.x 内置工具 + reasoning 的首选端点(Codex CLI 即走这条)。
Claude 池(X1,5 模型)#
claude-opus-4-6 claude-opus-4-7 claude-opus-4-8 claude-sonnet-4-6 claude-haiku-4-5-20251001
- Anthropic Messages ✅:原生字节透传,extended thinking /
server_tool_use块完整保留——Claude 系首选端点。 - OpenAI Chat 🔄 T1:网关翻译到 Anthropic 上游,响应带
X-Protocol-Translation: openai_chat_to_anthropic_messages。 - OpenAI Responses ✅:由独立通道直通承接。
Gemini 池(X1,3 模型)#
文本:gemini-2.5-flash gemini-3-flash-preview
- Gemini Native ✅ 原生;OpenAI Chat 🔄 T2(网关翻译,带
X-Protocol-Translation: openai_chat_to_gemini_native)。 - 图像 SKU(nano 家族)不在本矩阵:2026-07-08 起
nano-banana/nano-banana-pro/nano-banana-2统一走POST /v1/images/generations按张计费(旧 idgemini-3.1-flash-image等作为 alias 解析到 canonical 卡)。
多厂商池(X2,13 模型)#
| 厂商 | 模型 |
|---|---|
| xAI Grok | grok-4 grok-4-fast-reasoning grok-4-fast-non-reasoning grok-4.1 grok-4.2 |
| DeepSeek | deepseek-v3.2 deepseek-v4-flash deepseek-v4-pro |
| Moonshot Kimi | kimi-k2.5 kimi-k2.6 |
| MiniMax | MiniMax-M2.5 MiniMax-M2.7 |
| 智谱 GLM | glm-5 |
- 仅 OpenAI Chat ✅(这些上游本身就是 OpenAI 兼容协议),其余协议 —(503)。
- 2026-07-07 起
deepseek-v3.2/deepseek-v4-flash/deepseek-v4-pro/kimi-k2.5/kimi-k2.6/MiniMax-M2.5/MiniMax-M2.7/glm-5由 X3 通道独家承接,协议面不变。
混元 / DeepSeek 独占池(X3,5 模型)#
hunyuan-2.0-instruct-20251111 hunyuan-2.0-thinking-20251109 hunyuan-role-latest deepseek-v3-0324 deepseek-v3.1-terminus
- 仅 OpenAI Chat ✅,其余协议 —(503)。
豆包池(X4,21 模型)#
Doubao 1.5:doubao-1-5-lite-32k-250115 doubao-1-5-pro-32k-250115 doubao-1-5-pro-32k-character-250715 doubao-1-5-vision-pro-32k-250115
Doubao Seed 1.6:doubao-seed-1-6-250615 doubao-seed-1-6-251015 doubao-seed-1-6-flash-250615 doubao-seed-1-6-flash-250828 doubao-seed-1-6-vision-250815
Doubao Seed 1.8 / 2.0:doubao-seed-1-8-251228 doubao-seed-2-0-pro-260215 doubao-seed-2-0-lite-260215 doubao-seed-2-0-lite-260428 doubao-seed-2-0-mini-260215 doubao-seed-2-0-mini-260428 doubao-seed-2-0-code-preview-260215
专项:doubao-seed-character-251128 doubao-seed-code-preview-251028 doubao-seed-translation-250915
带版本后缀的路由分身:glm-4-7-251222 deepseek-v3-2-251201
- 仅 OpenAI Chat ✅,其余协议 —(503)。
Grok 池(X1,8 模型)#
grok-4.3 grok-4.20-0309-reasoning grok-4.20-0309-non-reasoning grok-4.20-multi-agent-0309 grok-build-0.1 grok-3-mini grok-3-mini-fast grok-composer-2.5-fast
- 仅 OpenAI Chat ✅,其余协议 —(503)。(
grok-4系 5 个模型走多厂商池 X2,见上。)
图像(
grok-imagine-*/doubao-seedream-*)与视频(doubao-seedance-*/grok-imagine-video*)SKU 走独立端点族,不属于本页 4 协议矩阵,见 图像 / 视频 API。
翻译路径的副作用#
走网关侧翻译(T1 / T2)时,响应附带诊断 header:
X-Protocol-Translation: openai_chat_to_anthropic_messages
X-Protocol-Warning: response_format=json_object dropped (Anthropic has no equivalent); n=2 dropped (Anthropic returns one completion)
X-Protocol-Translation的值是{客户端协议}_to_{上游协议}格式(见上方速查表)。X-Protocol-Warning按本次请求实际丢弃的字段生成,多条以;连接;请求没有触发任何丢弃时不返回该 header。常见丢弃:- OpenAI Chat → Anthropic(T1):
response_format、n、tools.image_generation等 Anthropic 无对应概念的字段 - Anthropic → OpenAI(T3,预留):
cache_control标记 - Gemini → Anthropic(T6,预留):
safetySettings/cachedContent/codeExecution
- OpenAI Chat → Anthropic(T1):
如果你的请求强依赖这些字段,选择能原生承载的协议端点(矩阵中标 ✅ 的列)更稳。上游侧转换(标「上游转换」的格子)不带这两个 header——网关看到的就是字节流,丢弃行为取决于上游。
怎么验证某个组合是否可用#
# 用你的 key 直接发请求,看 HTTP status 与响应 header
curl -i https://api.dflop.top/v1/chat/completions \
-H "Authorization: Bearer sk-gpushare-xxx" \
-H "Content-Type: application/json" \
-d '{"model":"<model-id>","messages":[{"role":"user","content":"hi"}]}'
- 200 —— 该组合可用;响应 header 里有
X-Protocol-Translation说明走了网关侧翻译路径,没有则是原生直通或上游侧转换。 - 400
model_not_found—— model id 根本不在模型注册表里(拼写错误或已下线),任何协议下都一样,message 形如model `xxx` is not available。 - 503
no_channel_available—— 模型存在,但当前协议没有可用通道。换矩阵中标 ✅ / 🔄 的端点(/v1/messages、/v1/responses或/v1beta/models/{id}:generateContent)再试。
矩阵中 ❔ 的格子建议照此实测后再上生产;标 — 的格子若实测返回 200,以实际响应为准(通道布线先于文档更新)。注意三种协议的错误响应体形状不同(OpenAI / Anthropic / Gemini 各按官方 schema),对照见 错误码。
实时性#
矩阵随通道布线变更而更新(本页核对于 2026-07)。最新模型清单另见:
- 公开 catalog:
GET /api/v1/models/public(免鉴权;含callable=false占位 SKU 与非 chat SKU,脚本接入需按callable与endpoint_type过滤) - 模型广场: model.dflop.top/models