豆包API需严格按ARK平台要求组织JSON：模型ID须精确匹配，外层必含model和messages（数组，每项含role/user/system与content），图像生成则用/images/generations路径及prompt/size等字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让豆包API正确解析你的请求并返回结构化结果，必须严格按火山引擎ARK平台要求组织JSON请求体，字段名、嵌套层级、数据类型缺一不可，漏掉一个引号或错位一个逗号都会触发400错误。
确认模型与基础字段结构
打开火山引擎控制台→进入“豆包大模型”服务→点击“模型广场”，找到你已开通的模型（如doubao-pro-32k或doubao-seedream-4-0-250828），记下其精确ID——【模型ID必须与控制台显示完全一致，大小写和连字符都不能错】。所有请求体最外层必须包含model、messages两个顶层字段，缺一不可。
messages字段必须是数组，且至少含一个对象，每个对象必须有role和content两个键；role只能是"user"、"system"或"assistant"，其他值（如"human"）将被直接拒绝。
构造标准对话类请求体
方法一：基础单轮问答
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
直接构建最小合法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":"你是一名中学语文教师，回答需符合《义务教育语文课程标准（2022年版）》要求，禁用网络用语"},{"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——【漏掉这个嵌套对象，即使写了max_images也不会生效】。
{"model":"doubao-seedream-4-0-250828","prompt":"水墨风格的江南水乡清晨","size":"2K","response_format":"url","sequential_image_generation":"auto","sequential_image_generation_options":{"max_images":4}}
