Claude 消息调用：格式转换与文本接入
用一个中文摘要场景比较 Claude Messages 与德他纯文本接口，说明系统提示、消息数组、输出限制和兼容性检查。
作者：德他数据技术团队 · 更新于 2026-09-24
核心解答
Claude 原生 Messages 的系统提示放在顶层 system，消息使用 user/assistant；德他兼容文本接口使用 messages 数组。只有获核准的具体文本方案才能走德他兼容入口，不能把原生请求或工具参数原样转发。
阅读范围与当前状态
本篇为完整的协议说明或接入准备指南，不代表所述原生、视频或扩展能力已在德他开放。真实调用以接口开放范围和具体模型的核准状态为准。
适用场景
本篇以“将会议纪要整理为三条结论”为例，说明怎样整理文本输入。它是协议转换参考，不是 Claude 原生端点已在德他开放的承诺。
原生消息与兼容消息的差异
| 项目 | Claude 原生 Messages | 德他当前文本入口 |
| --- | --- | --- |
| 系统提示 | 顶层 system | messages 中的系统消息 |
| 对话角色 | user、assistant | system、developer、user、assistant |
| 结果读取 | content 内容块 | choices 中的 message.content |
| 输出限制 | max_tokens | 两种输出上限字段二选一 |
原生协议结构参考如下，不是发往德他的请求：
{"model":"VENDOR_MODEL_ID","max_tokens":128,"system":"你是会议纪要助手。","messages":[{"role":"user","content":"请将以下纪要整理成三条结论：……"}]}
在德他准备一次兼容调用
1. 在模型广场确认具体方案 ID，并确认该文本方案的调用权限与付费策略。
2. 将系统指令与用户资料分离，用户资料只放在用户消息中，避免把外部内容当系统指令。
3. 参照文本对话示例构造纯字符串消息，明确输出上限，关闭流式。
4. 先检查答案是否完整，再结合请求编号核对费用；不要用模型品牌推定原生协议已经支持。
迁移时不应保留的扩展
图片内容块、工具调用、思考参数和流式事件都不属于当前德他文本开放范围。需要这些能力的业务应先评估适配，而不是删除报错字段后假装语义完全相同。
常见问题
能把原厂密钥换成德他令牌吗？
不能单独这样替换。域名、路径、鉴权和消息结构必须匹配同一协议。
系统提示可以放进 user 文本吗？
可以表达普通任务要求，但角色语义并不相同；需要系统约束时使用所选接口支持的系统字段。
延伸阅读
关联文档：德他数据教程。本文按德他实际功能独立编写。