对话补全 · 高级参数
本文档供调参、联调、对字段使用。端点速览与可复制示例见 创建对话补全。
请求体字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID，见 模型广场 |
messages | array | 是 | 见下节 messages[] |
stream | boolean | 否 | 默认 false |
stream_options | object | 否 | include_usage、chunk_include_usage（仅 stream=true） |
temperature | number | 否 | 常用 0~2 |
top_p | number | 否 | 常用 0~1 |
max_tokens | integer | 否 | 与 max_completion_tokens 互斥 |
max_completion_tokens | integer | 否 | 1~65536 |
thinking_enabled | boolean | 否 | 深度思考；按模型能力 |
reasoning_effort | string | 否 | none / minimal / low / medium / high 等 |
stop | string | string[] | 否 | 停止词，最多 4 个 |
response_format | object | string | 否 | text / json_object / json_schema |
frequency_penalty | number | 否 | 按模型能力 |
presence_penalty | number | 否 | 按模型能力 |
logprobs | boolean | 否 | 按模型能力 |
top_logprobs | integer | 否 | 需 logprobs=true |
tools | array | 否 | type: function + function.name |
parallel_tool_calls | boolean | 否 | 默认 true |
tool_choice | string | object | 否 | none / auto / required 或指定 function |
modalities | array | 否 | 生文建议省略或 ["text"] |
messages[]
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
role | string | 否 | system / user / assistant / tool |
content | string | array | 是 | string 或 Part 数组 |
tool_calls | array | 否 | 仅 role=assistant |
tool_call_id | string | 否 | 仅 role=tool 时必传 |
Part（content 为数组）
type | 说明 |
|---|---|
text | { "type": "text", "text": "..." } |
image_url | URL 或 data:image/...;base64,...；详见 图片输入 |
input_audio | input_audio.data（Base64）+ format：mp3 / wav |
file | file_url（≤70MB，可传视频）；可选 file_name；详见 视频输入 |
INFO
Part 用于生文看图/听音/读文件。生图参考图用 image_config.reference_images，见 图像生成 · 高级参数。
追踪与结算请求头
| 请求头 | 说明 |
|---|---|
X-Request-Id | 追踪 ID；最长 128 字符 |
X-Idempotency-Key | 结算幂等；重试同一笔业务须不变 |
X-Conversation-Id | 会话分组 |
TIP
不传 X-Idempotency-Key 时每次 HTTP 调用独立计费。网络超时重放应固定结算键。
思考模式（按模型）
| 模型示例 | 约束摘要 |
|---|---|
gpt-5.1 / gpt-5.2 / gpt-4o | 不支持 thinking_enabled / reasoning_effort |
gemini-3-pro-preview | 不允许 thinking_enabled=false；reasoning_effort 为 low / medium / high |
gemini-3-flash-preview | 默认开启思考；reasoning_effort 含 minimal 等 |
以 模型广场 与实际上线能力为准。
完整 JSON 示例
json
{
"model": "doubao-seed-1-6-thinking-agent-preview",
"messages": [
{ "role": "system", "content": "你是一个专业助手。" },
{ "role": "user", "content": "你好" }
],
"stream": false,
"temperature": 0.7,
"max_tokens": 1024,
"thinking_enabled": true,
"reasoning_effort": "medium",
"tools": [],
"tool_choice": "auto"
}