文本对话参数说明
详解德他文本对话接口的消息角色、输出上限、采样参数及同步响应，说明不支持字段和 Responses 协议边界。
作者：德他数据技术团队 · 更新于 2026-09-24
核心解答
文本消息 content 必须为字符串，role 支持 system、developer、user、assistant。max_tokens 与 max_completion_tokens 二选一；stream 仅支持 false，不支持工具、多模态消息或 /v1/responses。
请求
POST /v1/chat/completions ，JSON 请求体，Bearer 令牌鉴权。
| 字段 | 要求 | 说明 |
| --- | --- | --- |
| model | 必填字符串 | 已核准模型 ID |
| messages | 必填数组 | 最多 128 条纯文本消息 |
| max_tokens | 正整数 | 输出上限，与 max_completion_tokens 二选一 |
| max_completion_tokens | 正整数 | 替代输出上限字段 |
| stream | false | 不支持流式 |
| temperature | 可选数字 | 0 到 2 |
| top_p | 可选数字 | 0 到 1 |
消息格式
{"role":"user","content":"请总结以下内容。"}
消息内容必须是字符串；角色支持 system、developer、user、assistant。工具、多模态或额外字段会被拒绝。
输入长度与输出上限还受具体模型的核准策略限制。
响应与费用
接口返回同步文本结果与经过核验的 usage。平台先预留预算，确认用量后结算。
无法确认用量时进入待对账，不根据缺失字段猜测扣费。
Responses 不等于 Chat Completions
本平台没有开放 /v1/responses 。要求该协议的客户端不能只改 Base URL 后直接使用。
常见问题
developer 角色能否用于所有模型？
网关接受该角色，但具体模型仍须兼容并获核准。应用应按照所选模型的能力组织消息，不要依靠角色转换获得未开放功能。
接下来阅读
关联文档：德他数据教程。本文按德他实际功能独立编写。