创建视频生成任务

本文介绍创建视频生成任务 API 的输入输出参数，供您使用接口时查阅字段含义。模型会依据传入的图片及文本信息生成视频，待生成完成后，您可以按条件查询任务并获取生成的视频。

Seedance 2.0 不支持直接上传含有真人人脸的参考图/视频

Seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图/视频。为了便利创作者对肖像的使用，平台推出了以下解决方案，详情参见教程。

支持使用部分模型的含人脸原始产物作为输入素材
支持使用预置虚拟人像作为输入素材
支持使用已授权真人素材作为输入

完整调用流程

创建任务：调用本接口，从返回体的 id 取得任务 ID。
等待结果，二选一：
- 创建时填写了 callback_url，任务状态变化会异步推送到该地址；
- 或调用获取任务详情轮询，直到 status 进入终态。
取视频：status 为 succeeded 时，从 content.video_url 下载。该地址是带签名的临时地址，有效期至 content.expiredAt（任务 updated_at 之后 24 小时），过期后失效。需要长期保存的视频请在有效期内转存至己方存储，不要直接把该地址存库或分发给终端用户。

授权

BearerAuth

Authorization<token>

需要鉴权的接口请传入 Bearer <token> 形式的访问令牌。

位置: header

请求主体

application/json

视频生成任务创建请求

TypeScript 定义

在 TypeScript 中使用 request body 类型。

创建视频生成任务的请求体，参数适用于 Seedance 2.0 系列模型。 frames、draft、draft_task 不被接受，传入会返回 400 InvalidParameter；safety_identifier 会被接受并留存，但转发上游时一律替换为平台内部用户 ID；seed、camera_fixed、service_tier 在 Seedance 2.0 系列上不生效。

callback_url?string

接收任务状态通知的地址。任务状态变化时会向该地址发送 POST 请求，请求体与查询任务接口的响应结构一致。通知为异步发送，不会阻塞本次创建请求。

clientRequestId?string

你自定义的请求关联 ID，会记录在请求日志中，便于事后核对。它不是幂等键：用相同的值重试会创建多个任务，并分别计费。

content*array<>

用于生成视频的输入，至少 1 项。支持文本、图片、视频、音频四种类型，可按以下方式组合：

文本
文本（可选）+ 图片
文本（可选）+ 视频
文本（可选）+ 图片 + 音频
文本（可选）+ 图片 + 视频
文本（可选）+ 视频 + 音频
文本（可选）+ 图片 + 视频 + 音频

音频不能单独输入，需要搭配至少 1 个参考图片或参考视频。

1 <= items

duration?integer

生成视频的时长，单位秒，仅支持整数，默认 5。取值范围 [4, 15]，或设为 -1 表示由模型在有效范围内自主选择合适的时长。实际生效的时长可从查询任务接口返回的 duration 字段获取。该参数直接影响费用，设为 -1 前请评估成本。

execution_expires_after?integer

任务超时阈值，单位秒，从 created_at 时间戳开始计算。默认 172800（48 小时），取值范围 [3600, 259200]。超过该时间后任务被自动终止并标记为 expired。

generate_audio?boolean

生成的视频是否包含与画面同步的声音，默认 true。

true：模型基于文本提示词与画面内容，自动生成匹配的人声、音效与背景音乐；建议将对话内容写在双引号内以优化音频生成效果。
false：输出无声视频。

生成的有声视频均为单声道，与输入音频的声道数无关。该参数会影响费用。

model*string

要调用的模型 ID，例如 seedance-2.0、seedance-2.0-fast。可用模型的完整列表以控制台为准。

priority?integer

任务的排队优先级，默认 0，取值范围 [0, 9]，数值越大优先级越高。

任务默认按提交顺序执行，设置较高优先级可以让任务排到已排队的低优先级任务之前；优先级相同的任务之间仍按提交顺序排列。优先级只影响排队顺序，不会中断正在生成（running）的任务，也不保证任务立即开始生成。

ratio?string

生成视频的宽高比，默认 adaptive。

adaptive 表示由模型根据输入自动选择最合适的宽高比：文生视频按提示词判断；首帧 / 首尾帧生视频按首帧图片的比例；多模态参考生视频按提示词意图判断，否则以传入的第一个媒体文件为准（视频优先于图片）。实际生效的比例可从查询任务接口返回的 ratio 字段获取。

图生视频时，若选择的宽高比与上传图片不一致，系统会对图片做居中裁剪。

值于

"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"

resolution?string

视频分辨率，默认 720p。

480p、720p：全部模型支持。
1080p：seedance-2.0-fast 不支持。
4k：仅 seedance-2.0 支持；采用 10bit 位深与 H.265 编码，少数播放环境可能不兼容，建议使用 VLC、MPV、QuickTime Player 等播放器。

该参数会影响费用。

值于

"480p"
"720p"
"1080p"
"4k"

return_last_frame?boolean

是否返回生成视频的尾帧图像，默认 false。设为 true 后可通过查询任务接口获取 content.last_frame_url，尾帧图像的宽高与生成视频一致且无水印。常用于以上一段视频的尾帧作为下一段视频的首帧，连续生成多段视频。

safety_identifier?string

你自己的终端用户标识，最长 256 字符，用于把一次生成关联到你侧的具体用户，便于事后排查与追责。该值会被记录在请求日志中（平台侧详情的 clientSafetyIdentifier 字段），但不会原样转发给上游：请求转发时该字段一律被替换为平台内部的用户 ID。

tools?array<>

配置模型可以调用的工具，当前仅支持联网搜索。

watermark?boolean

生成视频是否包含水印，默认 false。设为 true 时视频右下角会展示 AI 生成水印。

响应主体

`application/json`

在线请求

「发送」会向所选服务器地址发起真实调用，与生产环境请求等效，可能产生计费。

请求示例

curl -X POST "https://example.com/api/v3/contents/generations/tasks" \  -H "Content-Type: application/json" \  -d '{    "model": "seedance-2.0",    "content": [      {        "type": "text",        "text": "镜头缓慢推近海面，日出时分，光线温暖。"      }    ],    "ratio": "16:9",    "resolution": "720p",    "duration": 5,    "watermark": false,    "callback_url": "https://your-server.example.com/webhooks/seedance"  }'

响应示例

{  "content": {    "expiredAt": "2026-06-04T10:02:00Z",    "last_frame_url": "https://cdn.example.com/last-frame.png",    "video_url": "https://cdn.example.com/output.mp4"  },  "created_at": 1712664960,  "duration": 5,  "error": {    "code": "upstream_failed",    "message": "seedance task failed upstream"  },  "execution_expires_after": 172800,  "framespersecond": 24,  "generate_audio": false,  "id": "task_019db400-0000-7000-8000-000000000001",  "model": "seedance-2.0",  "ratio": "16:9",  "resolution": "720p",  "revised_prompt": "A cinematic ocean wave at sunset, golden hour lighting.",  "seed": 42,  "service_tier": "default",  "status": "succeeded",  "updated_at": 1712664990,  "usage": {    "completion_tokens": 88,    "tool_usage": {      "web_search": 0    },    "total_tokens": 88  }}

{  "error": {    "code": "InvalidParameter",    "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35",    "param": "content",    "reasonCode": "seedance_text_blocked_by_moderation",    "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437",    "type": "BadRequest"  }}

{  "error": {    "code": "InvalidParameter",    "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35",    "param": "content",    "reasonCode": "seedance_text_blocked_by_moderation",    "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437",    "type": "BadRequest"  }}

{  "error": {    "code": "InvalidParameter",    "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35",    "param": "content",    "reasonCode": "seedance_text_blocked_by_moderation",    "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437",    "type": "BadRequest"  }}

{  "error": {    "code": "InvalidParameter",    "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35",    "param": "content",    "reasonCode": "seedance_text_blocked_by_moderation",    "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437",    "type": "BadRequest"  }}

{  "error": {    "code": "InvalidParameter",    "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35",    "param": "content",    "reasonCode": "seedance_text_blocked_by_moderation",    "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437",    "type": "BadRequest"  }}

{  "error": {    "code": "InvalidParameter",    "message": "The parameter content specified in the request is not valid. Request id: 0217790892668142434549f79b621a35",    "param": "content",    "reasonCode": "seedance_text_blocked_by_moderation",    "requestId": "seedance_req_019e8808-d40e-7ccd-873c-072b78b15437",    "type": "BadRequest"  }}

常见问题

输入素材包含真人人脸

直接传入含真人人脸的图片或视频会被拦截，返回 400：

{
  "error": {
    "code": "InputImageSensitiveContentDetected.PrivacyInformation",
    "message": "The request failed because the input image may contain real person.",
    "param": "",
    "type": "BadRequest"
  }
}

要使用这类素材，先把它上传到素材库完成肖像授权，再把 url 换成素材库返回的素材 ID 重新提交：

{
  "type": "image_url",
  "role": "first_frame",
  "image_url": { "url": "asset://<ASSET_ID>" }
}

image_url、video_url、audio_url 三种素材的用法一致，都是把素材 ID 填在各自的 url 字段里。

上传与授权步骤见素材库。

创建视频生成任务

完整调用流程

接口详情

授权

请求主体

响应主体

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

在线请求

请求示例

响应示例

常见问题

输入素材包含真人人脸

参考文档

Seedance 2.0 价格计算器

本页目录

创建视频生成任务

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

本页目录

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`