# 创建视频生成任务

URL: http://localhost:3000/docs/zh-cn/api/createSeedanceTask

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





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

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

## 完整调用流程 [#完整调用流程]

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

## 接口详情 [#接口详情]

<OpenAPIPage document="public" operations="[{&#x22;path&#x22;:&#x22;/api/v3/contents/generations/tasks&#x22;,&#x22;method&#x22;:&#x22;post&#x22;}]" examples="examples" />

## 常见问题 [#常见问题]

### 输入素材包含真人人脸 [#输入素材包含真人人脸]

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

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

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

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

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

上传与授权步骤见[素材库](/zh-cn/api/asset-library)。

## 参考文档 [#参考文档]

### Seedance 2.0 价格计算器 [#seedance-20-价格计算器]

<Embed title="Seedance 2.0 价格计算器" src="https://bytedance.larkoffice.com/share/base/form/shrcnP1Bl0mqCP9OHCbjpe1oBkf" />


---

本页对应接口：`POST /api/v3/contents/generations/tasks`。机器可读的完整 schema：

- 本接口 schema：http://localhost:3000/docs/openapi/operations/createSeedanceTask.zh.json
- 完整对外 spec（供代码生成工具使用）：http://localhost:3000/docs/openapi/public.zh.json