火山引擎豆包API请求体JSON格式配置教程

豆包API需严格按ARK平台要求组织JSON：模型ID须精确匹配，外层必含model和messages（数组，每项含role/user/system与content），图像生成则用/images/generations路径及prompt/size等字段。

要让豆包API正确解析你的请求并返回结构化结果，必须严格按火山引擎ARK平台要求组织JSON请求体，字段名、嵌套层级、数据类型缺一不可，漏掉一个引号或错位一个逗号都会触发400错误。

确认模型与基础字段结构

打开火山引擎控制台→进入“豆包大模型”服务→点击“模型广场”，找到你已开通的模型（如doubao-pro-32k或doubao-seedream-4-0-250828），记下其精确ID——

messages字段必须是数组，且至少含一个对象，每个对象必须有role和content两个键；role只能是"user"、"system"或"assistant"，其他值（如"human"）将被直接拒绝。

构造标准对话类请求体

方法一：基础单轮问答

直接构建最小合法JSON：

{"model":"doubao-pro-32k","messages":[{"role":"user","content":"今天北京天气如何？"}],"temperature":0.5}

注意：temperature必须是0～1之间的浮点数，传整数0或1会被接受，但传字符串"0.5"会报错；该字段非必需，但显式声明可避免服务端使用默认值导致结果不稳定。

方法二：带系统指令的双消息结构

第一项设为system角色，用于约束模型行为：

{"model":"doubao-edu-128k","messages":[{"role":"system","content":"你是一名中学语文教师，回答需契合《义务教育语文课程标准（2024年版）》要求，不可使用网络用语"},{"role":"user","content":"请赏析‘落霞与孤鹜齐飞’的修辞手法"}],"max_tokens":512}

这一步的关键在于system message必须放在messages数组首位，否则模型可能忽略指令；max_tokens设为512可防止长输出截断，但不能超过所选模型的最大上下文长度。

图像生成类请求体特殊配置

第一步：切换到视觉模型接口

图生图请求不走/chat/completions，而必须用/images/generations路径，因此model字段必须填视觉专用ID，例如doubao-seedream-4-0-250828。

第二步：替换核心字段名

删除messages，改用prompt（字符串）、size（字符串，如"1024x1024"）、response_format（"url"或"b64_json"）三个必填字段。

第三步：添加批量生成控制

若需一次生成4张图，必须加入sequential_image_generation字段并设为"auto"，同时嵌套sequential_image_generation_options对象，其中max_images设为4——

{ "model": "doubao-seedream-4-0-250828", "prompt": "江南水乡的清晨，那是一幅如梦如幻的水墨画卷", "size": "2K", "response_format": "url", "sequential_image_generation": "auto", "sequential_image_generation_options": { "max_images": 4 } }