德他数据 / API 教程

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

关联文档:德他数据教程。本文按德他实际功能独立编写。