> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建视频生成任务

> Seedance 2.0 New POST /api/v3/contents/generations/tasks

## 简介

提交 Seedance 2.0 官方镜像异步视频生成任务，成功返回任务 `id`。`content` 与 `prompt` 至少提供一个。

与 BytePlus Ark 官方接口请求体、响应体完全一致。

## 认证

<ParamField header="Authorization" type="string" required>
  Bearer Token，如 `Bearer sk-your_token_key`
</ParamField>

<ParamField header="Content-Type" type="string">
  `application/json`
</ParamField>

## 请求参数

<ParamField body="model" type="string" required>
  模型 ID：`seedance-2-0` / `seedance-2-0-fast` / `seedance-2-0-NSFW`
</ParamField>

<ParamField body="content" type="array">
  内容数组：`text` / `image_url` / `video_url` / `audio_url`，各元素可带 `role`（`first_frame` / `last_frame` / `reference_image` / `reference_video` / `reference_audio`）；与 `prompt` 至少提供一个
</ParamField>

<ParamField body="prompt" type="string">
  简化写法，与 `content` 二选一
</ParamField>

<ParamField body="callback_url" type="string">
  任务状态变化时的回调地址
</ParamField>

<ParamField body="return_last_frame" type="boolean" default="false">
  是否返回最后一帧图片
</ParamField>

<ParamField body="service_tier" type="string" default="default">
  `default` / `flex`
</ParamField>

<ParamField body="execution_expires_after" type="integer" default="172800">
  任务过期时间（秒），范围 `[3600, 259200]`
</ParamField>

<ParamField body="generate_audio" type="boolean" default="true">
  是否生成音频
</ParamField>

<ParamField body="safety_identifier" type="string">
  终端用户唯一标识（建议传用户 ID 的哈希）
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  `480p` / `720p` / `1080p` / `4K`（`seedance-2-0-fast` 仅支持 `480p`/`720p`）
</ParamField>

<ParamField body="ratio" type="string" default="adaptive">
  `16:9` / `4:3` / `1:1` / `3:4` / `9:16` / `21:9` / `adaptive`
</ParamField>

<ParamField body="duration" type="integer" default="5">
  秒数，`[4,15]` 或 `-1`（自动）
</ParamField>

<ParamField body="seed" type="integer" default="-1">
  随机种子
</ParamField>

<ParamField body="watermark" type="boolean" default="false">
  是否加水印
</ParamField>

<Note>
  `content[].image_url.url` / `video_url.url` / `audio_url.url` 支持三种值：公网 URL、Base64（`data:image/png;base64,...`）、`asset://&lt;ASSET_ID&gt;` 素材库引用。
</Note>

## 请求示例

```bash theme={null}
curl -X POST https://api.gravitex.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-your_token_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      {"type": "text", "text": "黄金时刻，无人机航拍连绵山脉"}
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'
```

## 响应示例

```json theme={null}
{
  "id": "cgt-20260708094649-mxfjc"
}
```

下一步：[查询视频生成任务](/cn/api-reference/endpoint/seedance-2.0-new/get-video-generation)