德他数据 / API 教程

Gemini 与 Claude:原生协议与兼容接入

比较 Gemini 与 Claude 原生协议和文本兼容接入,说明消息格式、工具与流式能力,以及德他当前的开放范围。

作者:德他数据技术团队 · 更新于 2026-09-24

核心解答

Gemini 原生 contents/parts 与 Claude 原生 Messages 不等于 Chat Completions。德他当前只对已核准模型提供非流式纯文本兼容入口;原生、多模态、工具和流式功能不能直接迁移。

阅读范围与当前状态

本篇为完整的协议说明或接入准备指南,不代表所述原生、视频或扩展能力已在德他开放。真实调用以接口开放范围和具体模型的核准状态为准。

原生 SDK 不等于兼容接入

模型名称与调用协议是两个维度。选择 Gemini 或 Claude 产品后,仍需确认平台开放的是哪种接口。不要假设厂商原生 SDK 只需修改 base URL 就能使用。

当前可用范围

德他对已逐项核准的模型提供非流式纯文本对话。Google 与 Anthropic 原生协议、工具调用、多模态输入和流式输出不在当前公开范围内。部分模型是否支持兼容接口,须由商品开放策略确认。

| 检查项 | 需要确认的内容 |

| --- | --- |

| 模型 | 使用模型广场提供的准确模型 ID |

| 路径 | 当前公开文本路径为 /v1/chat/completions |

| 消息 | 使用纯字符串文本,不发送多模态内容数组 |

| 流式 | 当前使用非流式请求 |

| 工具 | 当前不发送工具定义或工具调用参数 |

| 原生协议 | 等待专门适配,不使用猜测的原生路径 |

客户端迁移检查

1. 判断现有应用使用原生 SDK 还是 HTTP 兼容请求。

2. 如使用原生 SDK,先检查它是否可以切换为兼容接口;无法切换时不要强行替换域名。

3. 移除尚未支持的工具、流式和多模态参数。

4. 逐项核对 token 上限、温度等参数,按德他文档约束构造请求。

5. 在确认付费授权后,以受控预算验证结果格式与调用记录。

为什么不能照搬原生示例

不同协议在鉴权字段、系统消息位置、内容结构、响应格式和错误对象上可能不同。客户端的成功解析也不能证明计费策略或任务流程已正确适配。平台需要逐项核验后才会开放相应能力。

常见问题

能直接使用 Claude 或 Gemini 原生消息接口吗?

当前不能通过德他调用这些原生接口。请先检查兼容文本调用是否覆盖目标模型,否则等待适配。

编程工具提示必须支持流式或工具调用怎么办?

这类客户端可能不适合当前接口范围。不要把未支持的特性简单删除后承诺完整兼容,应先确认客户端是否允许关闭对应能力。

继续阅读

- 文本对话参数说明

- JavaScript HTTP 接入示例

- 接口开放范围

常见问题

原厂 SDK 只改域名就能使用吗?

不能保证。必须检查 SDK 的实际请求路径、鉴权头、消息结构和自动附带参数是否与已开放接口一致。

接下来阅读

接口开放范围 · 错误码排查 · 密钥安全与上线检查