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

# Seedance 2.0

> 使用字节官方模型 ID 和 content[] JSON 创建 Seedance 2.0 视频任务

POST

▶

<dialog>
  <form>
    ➤×

    API Key \*Bearer

    ### cURL

    <pre aria-label="cURL" />

    <pre aria-live="polite" />
  </form>
</dialog>

使用字节官方模型 ID `dreamina-seedance-2-0-260128`。沿用官方 JSON 请求结构，替换视频基础 URL 和 API Key 即可接入 TensorAI；资产管理的 URL、AK/SK 替换方式见 [迁移配置](https://docs.tensorslab.com/zh/api-reference/seedance/introduction.md)。

点击“试一试”创建任务；成功后可点击“查询任务”，自动带入任务 ID 和 API Key。已有任务可使用 [查询视频任务](https://docs.tensorslab.com/zh/api-reference/seedance/query-task.md?playground=open) 查看状态和结果。

## 创建任务

```bash theme={null}
curl -X POST "https://api.tensorslab.com/v1/video/contents/generations/tasks" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-260128",
    "content": [{"type": "text", "text": "一只纸船漂过平静的湖面，镜头缓慢推进"}],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }'
```

成功返回 HTTP 200：

```json theme={null}
{"id":"task_example"}
```

保存返回的 `id`，用于查询任务状态和视频结果。

## 请求参数

| 参数 | 类型 | 说明 |
| - | - | - |
| `model` | string，必填 | 字节官方 ID `dreamina-seedance-2-0-260128` |
| `content` | object\[]，必填 | 按官方格式传入文本、图片、音频、视频等内容 |
| `duration` | integer | 秒数，`4–15` 或 `-1`（自动选择）；省略时由模型决定 |
| `resolution` | string | `480p`、`720p`、`1080p`，具体组合受模型约束 |
| `ratio` | string | `adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16` |
| `generate_audio`、`watermark`、`return_last_frame` | boolean | 音画同步、水印、返回尾帧，按模型能力处理 |
| `seed` | integer | `-1–2147483647`，受模型能力限制 |
| `frames` | integer | `29–289` 且为 `25+4n`；优先于 `duration`，受模型能力限制 |
| `execution_expires_after` | integer | 执行有效期（秒），`3600–259200` |
| `priority` | integer | 执行优先级 `0–9` |
| `safety_identifier`、`callback_url`、`service_tier` | string | 安全标识、回调地址、服务等级，原样转发 |
| `draft`、`camera_fixed` | boolean | 样片模式、固定镜头，受模型能力限制 |
| `tools` | object\[] | 工具列表；当前最多一个 `{"type":"web_search"}`，是否可用取决于模型 |

请求体上限为 64 MiB。布尔参数请使用 JSON 的 `true` / `false`；可选参数未传时由模型决定，传入值须符合字段及模型要求。

2.0 不接受 `output_format` 和 `omni_reference_task_type`；需要这些参数时请使用 [Seedance 2.5](https://docs.tensorslab.com/zh/api-reference/seedance/seedance-2-5.md)。参数是否可用以模型能力为准。

## 素材与 content

| 类型 | 内容字段 | `role` |
| - | - | - |
| 文本 | `text` | 不需要 |
| 图片 | `image_url.url` | `first_frame`、`last_frame`、`reference_image`；可省略，按官方首帧语义处理 |
| 音频 | `audio_url.url` | `reference_audio` |
| 视频 | `video_url.url` | `reference_video` |

素材可使用公网 HTTP(S) URL 或当前账号的 `asset://<ASSET_ID>`。图片、音频还支持 Base64 Data URL（解码后分别最多 30 MiB、15 MiB）；视频暂不支持内联 Base64。公网 URL 不能指向本地或私网地址。

例如，把创建请求中的 `content` 替换为参考图输入：

```json theme={null}
[
  {"type":"text","text":"保持参考角色的外观，让角色在雨中漫步"},
  {"type":"image_url","image_url":{"url":"asset://<ASSET_ID>"},"role":"reference_image"}
]
```

“试一试”默认提供一条文本和一条图片。通过 `type` 选择素材类型，填写对应字段；其他素材可点击“添加项目”继续添加，也可删除不需要的项目。

已有资产引用会校验归属和状态。手动管理资产的创建、查询与活体校验见 [资产管理](https://docs.tensorslab.com/zh/api-reference/seedance/assets.md)。

## 查询结果

[试一试：查询视频任务](https://docs.tensorslab.com/zh/api-reference/seedance/query-task.md?playground=open)。Seedance 2.0、2.5 共用同一查询接口。

```bash theme={null}
curl "https://api.tensorslab.com/v1/video/contents/generations/tasks/<TASK_ID>" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
```

| `status` | 含义 |
| - | - |
| `queued` | 已排队 |
| `running` | 正在处理（包括结果转存） |
| `succeeded` | 成功，读取 `content.video_url` |
| `failed`、`cancelled`、`expired` | 终态，查看 `error.code` / `error.message` |

成功响应示例（可选元数据以实际返回为准）：

```json theme={null}
{
  "id":"task_example",
  "model":"dreamina-seedance-2-0-260128",
  "status":"succeeded",
  "content":{"video_url":"https://example.com/output.mp4","last_frame_url":"","file_url":""},
  "usage":{"prompt_tokens":0,"completion_tokens":1000,"total_tokens":1000},
  "resolution":"720p","ratio":"16:9","duration":5,"framespersecond":24,
  "created_at":1794787200,"updated_at":1794787260
}
```

只可查询当前账号创建的任务。主视频地址为平台转存地址；启用并成功返回尾帧时读取 `content.last_frame_url`。自动时长场景读取查询结果的实际 `duration`。

## 官方 Python SDK 接入

以下示例使用官方 `volcenginesdkarkruntime` SDK。SDK 安装说明见 [官方文档](https://docs.volcengine.com/docs/ark/install-and-upgrade-sdk?lang=zh)。

```bash theme={null}
pip install 'volcengine-python-sdk[ark]'
```

设置环境变量 `PLATFORM_API_KEY` 为 TensorAI API Key：

```python theme={null}
import os
import time
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ["PLATFORM_API_KEY"],
             base_url="https://api.tensorslab.com/v1/video")
task = client.content_generation.tasks.create(
    model="dreamina-seedance-2-0-260128",
    content=[{"type":"text","text":"A paper boat floating on a quiet lake"}],
    duration=5, resolution="720p", ratio="16:9",
)
for _ in range(240):
    result = client.content_generation.tasks.get(task_id=task.id)
    if result.status == "succeeded":
        print(result.content.video_url)
        break
    if result.status in {"failed", "cancelled", "expired"}:
        raise RuntimeError(result.error)
    time.sleep(5)
else:
    raise TimeoutError("Retain task.id and query again later")
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.