Claude 原生 Messages:系统提示与内容块
介绍 Claude Messages 的系统提示、消息轮次和内容块响应,说明与德他文本兼容协议的差异以及原生能力开放限制。
作者:德他数据技术团队 · 更新于 2026-09-24
核心解答
Claude 原生 Messages 使用顶层 system、user/assistant 消息和 content 内容块,与德他 Chat Completions 的消息及结果结构不同。德他原生 Messages、工具和流式当前未开放,原厂 SDK 不能只换域名后直接使用。
阅读范围与当前状态
本篇为完整的协议说明或接入准备指南,不代表所述原生、视频或扩展能力已在德他开放。真实调用以接口开放范围和具体模型的核准状态为准。
认识原生 Messages
原生请求中的 system 与 messages 分开:系统提示定义任务约束,对话数组承载用户与助手轮次。结果需要按内容块读取,而不是假定与 choices[0].message.content 相同。
与兼容文本的差别
| 项目 | 需要注意 |
| --- | --- |
| 请求路径 | 原生 Messages 与兼容 Chat Completions 不同 |
| 系统提示 | 原生顶层字段不能原样作为德他扩展参数 |
| 消息角色 | 原生和兼容接口支持的角色集合不同 |
| 内容类型 | 文本之外的内容块不能直接迁移 |
| 返回解析 | 必须使用所选协议的结果结构 |
| 鉴权 | 使用与入口匹配的凭据和请求头 |
应用迁移方法
将应用中的协议解析与业务提示分开,先确定是否只依赖文本。如果包含工具执行、媒体输入或流式事件处理,当前德他入口不能完整承接该应用。纯文本场景也要核对模型方案已获核准,再使用文本对话示例。
不要静默降级关键能力
删除 tools 或多模态输入后即使请求成功,也可能丢失业务核心功能。应明确提示使用者当前能力限制,避免将只生成文字的结果当作真实工具执行或素材理解。
常见问题
能将顶层 system 直接放进德他请求吗?
不能按原生格式原样提交;应按德他文本消息文档组织系统指令。
原生流式客户端能切换为非流式吗?
需要客户端本身支持该模式和结果解析;不能仅修改网络地址。
原厂密钥和德他令牌是否通用?
不通用,两种凭据对应不同服务与权限。
Claude 消息示例 · Claude 官方 Messages
关联文档:德他数据教程。本文按德他实际功能独立编写。