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

# 视频生成总览

> Dreamina Seedance 2.0 / Mini / Fast 的视频生成调用流程。

视频生成是一个异步流程。提交任务后先拿到 `task id`，再轮询查询接口直到成功。

## 适用模型

| 模型                           | 用途      | 说明            |
| ---------------------------- | ------- | ------------- |
| `dreamina-seedance-2-0`      | 标准视频生成  | 默认推荐，适合通用视频任务 |
| `dreamina-seedance-2-0-mini` | 轻量视频生成  | 更轻量的模型        |
| `dreamina-seedance-2-0-fast` | 低延迟视频生成 | 更适合追求速度的任务    |

## 调用顺序

1. 调用 `POST /v1/videos/generations` 创建任务。
2. 保存返回的 `id`。
3. 轮询 `GET /v1/videos/generations/{id}`。
4. `status=succeeded` 后下载 `content.video_url`。

## 素材接口

`POST /v1/assets` 可以把公网图片、视频、音频转成平台素材，生成任务时再用 `asset://asset_xxx` 复用。

| 页面                               | 方法   | 说明         |
| -------------------------------- | ---- | ---------- |
| [创建素材](/api/videos/create-asset) | POST | 上传公网素材 URL |
| [查询素材](/api/videos/get-asset)    | GET  | 查询单个素材状态   |
| [素材列表](/api/videos/list-assets)  | GET  | 查询素材列表     |

| 接口                            | 方法   | 说明           |
| ----------------------------- | ---- | ------------ |
| `/v1/videos/generations`      | POST | 提交视频生成任务     |
| `/v1/videos/generations/{id}` | GET  | 查询任务状态、结果和用量 |

## 注意

1. 任务成功后从 `content.video_url` 下载结果，链接有过期时间。
2. 素材只有 `status=active` 时才能用于视频生成。
3. 建议轮询间隔 5 到 10 秒。