提交任务(豆包 / Seedance 格式)
豆包视频模型(Seedance 系列,如 seedance-1-0-pro-250528、doubao-seedance-2-0-260128、doubao-seedance-2-0-mini-260615,以模型广场为准)复用通用任务格式的端点,无需单独对接(请求结构总览见创建视频生成任务)。本页说明豆包渠道的参数映射与渠道差异;查询与下载见查询与下载。
端点
创建与查询分别复用通用任务格式端点:POST /v1/video/generations、GET /v1/video/generations/{task_id}。
请求体
网关把请求转换为上游的 {model, content[], ...参数} 结构转发:prompt 转为上游 content 中的文本条目,image / images 转为图片条目;其余生成参数全部通过 metadata 按字段名合并进上游请求体(无法识别的 key 丢弃)。
顶层 duration、size、mode、width、height、fps、seed、n、response_format、user 在豆包渠道静默丢弃(不报错、不生效):时长用 seconds,画幅与分辨率用 metadata.ratio + metadata.resolution。实测对照:同一请求顶层 duration: 8 + seconds: "5",产出 5 秒;顶层 seed: 999 + metadata.seed: 42,回显 42。
上游按「模型 × 模式」逐参数校验:不支持的组合在提交时直接返回 400(message 含模型名、模式与 Request id),按报错删掉对应参数重试即可。已实测(2026-09):
doubao-seedance-2-0-260128t2v:resolution/ratio/seed/duration/generate_audio/return_last_frame/watermark/camera_fixed均生效(1080p 产物与音轨实测;camera_fixed为 2026-10 复测修正——t2v 传 200 正常建单,true/false运镜差异明显);frames/service_tier不支持doubao-seedance-2-0-mini-260615i2v:ratio/generate_audio生效(720p 产物含音轨);resolution不支持,不传时固定 720p- 文生视频帧率均为 24fps,不可调;其余「模型 × 模式」组合未实测,以上游报错为准
图生视频(i2v)的 image / images 不接受真人照片:命中火山合规检测会直接返回 400 InputImageSensitiveContentDetected.PrivacyInformation(不建单、不计费)。首帧请改用插画 / 动漫 / 产品 / 风景类图片。
请求示例
响应体
提交成功返回任务对象,task_id 用于查询,status 起始为 queued。
响应示例
查询状态与下载见查询与下载。
