{"model":"seedance-2.0","prompt":"阳光斜射在青砖墙面上形成45度角阴影","seconds":8,"metadata":{"resolution":"1080p","ratio":"16:9"},"watermark":false,"generate_audio":true,"camera_fixed":false}
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要用标准JSON格式构造Seedance视频生成API的请求体，字段名拼写、嵌套层级、数据类型稍有偏差就会返回422错误或静默失败，不能只靠复制粘贴模板。
基础结构必须包含的字段
所有请求都必须带model、prompt、seconds三个顶层字段，缺一不可。model值必须严格匹配官方文档列出的Model ID，比如seedance-2.0，不能写成seedance2.0或Seedance-2.0。prompt不能为空字符串，也不能只有空格，否则任务直接被拒绝。
seconds必须是数字类型（不是字符串），取值范围为4～15，超出范围会触发422校验失败。
【model字段必须小写且带连字符，写成SEEDANCE-2.0或seedance20将导致404】
metadata对象的写法要点
resolution和ratio必须放在metadata对象内部，不能平级写在根节点。这两个字段都是字符串类型，但可选值受硬性限制：resolution只能是"480p"、"720p"、"1080p"、"4k"四者之一；ratio只能是"21:9"、"16:9"、"4:3"、"1:1"、"3:4"、"9:16"之一。
watermark、generate_audio、camera_fixed等布尔字段，必须写true或false，不能写"true"、"false"或1/0，否则解析失败。
seed字段可选，但一旦填写就必须是整数，小数或负数会被截断或报错。
多模态混合输入的JSON结构
方法一：文本+图片组合（图生视频首帧）
在content数组中按顺序放入text和image类型对象，image的url必须是公网可直访的HTTPS地址，且图片格式为JPG/PNG，大小不超过8MB。
方法二：纯文本驱动（文生视频）
content数组只保留一个type为text的对象，text字段内描述需包含画面主体、环境、运镜、光影等维度，避免抽象词如“美丽”“震撼”，改用“阳光斜射在青砖墙面上形成45度角阴影”这类可渲染描述。
方法三：带音频参考的视频生成
在content数组末尾追加一个type为audio的对象，url字段填MP3/WAV格式的音频公网链接，时长建议控制在5～12秒，过长会导致超时。
异步任务的完整请求链路
第一步：发送POST请求到/v1/video/generations接口，携带Authorization头和正确JSON体→
第二步：从响应中提取task_id字段值→
第三步：用该task_id拼接GET请求地址，轮询/task_xxx路径→
第四步：检查响应中data.status是否为SUCCESS→
第五步：取出data.result_url下载视频文件。
注意：查询接口返回的result_url有效期仅24小时，过期链接无法重放。
