# Seedance 2.0

> 通过 UniAI 视频 API 调用 Seedance 2.0 模型生成视频。

Canonical URL: https://docs.uniai.tv/models/video/seedance-2-0
Locale: zh-CN

Seedance 2.0 支持文生视频、图生视频、首尾帧、多模态参考、视频编辑和视频延长。新接入请从 [Seedance 2.0 系列调用指南](/models/video/seedance-2-0/series-guide) 开始；复用图片、视频或音频的创建与使用方法见 [Seedance 2.0 素材库](/models/video/seedance-2-0/material-library)。

## 支持模型

| 模型 | 支持分辨率 | 适用场景 |
| --- | --- | --- |
| `seedance2.0` | `480p`、`720p`、`1080p`、`4k` | 综合质量优先，支持完整能力。 |
| `seedance2.0-fast` | `480p`、`720p` | 生成速度优先。 |
| `seedance2.0-mini` | `480p`、`720p` | 轻量、速度优先。 |

## Endpoint

```http
POST /v1/videos
GET  /v1/videos/{task_id}
GET  /v1/videos/{task_id}/content
```

旧客户端仍可继续使用 `/v1/videos/generations` 和 `/v1/video/generations` 创建接口。

## Authentication

```http
Authorization: Bearer sk-***
Content-Type: application/json
```

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `model` | string | 是 | `seedance2.0`、`seedance2.0-fast` 或 `seedance2.0-mini`。 |
| `resolution` | string | 是 | 所选模型支持的分辨率。 |
| `prompt` | string | 条件必填 | 视频提示词；使用 `content[]` 时改为 `type=text` 项。 |
| `duration` | integer/string | 是 | 输出时长，支持 `4` 到 `15` 秒。 |
| `aspect_ratio` | string | 否 | 输出宽高比；兼容别名为 `ratio`。 |
| `content` | object[] | 否 | 带明确角色的文本、图片、视频和音频多模态输入。 |
| `operation` | string | 条件必填 | `reference_to_video`、`edit_video` 或 `extend_video`。 |
| `generate_audio` | boolean | 否 | 是否生成带音频的视频。 |
| `return_last_frame` | boolean | 否 | 是否返回生成视频的尾帧。 |

## 请求示例

```bash
curl -X POST "https://api.uniai.tv/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0",
    "prompt": "A clean commercial product video with slow camera movement, soft reflections, and realistic lighting.",
    "resolution": "720p",
    "duration": 8,
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "seed": 42,
    "watermark": false
  }'
```

## 多参考图示例

```bash
curl -X POST "https://api.uniai.tv/v1/videos" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-fast",
    "resolution": "720p",
    "duration": 6,
    "aspect_ratio": "9:16",
    "operation": "reference_to_video",
    "content": [
      {
        "type": "text",
        "text": "制作一段快速时尚 Lookbook 视频，并保持产品外观一致。"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/model.png"},
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/outfit.png"},
        "role": "reference_image"
      }
    ],
    "generate_audio": true
  }'
```

## 任务状态与结果

创建成功后保存 `id` 或 `task_id`，随后调用 `GET /v1/videos/{task_id}`，直到任务进入 `completed` 或 `failed`。统一的轮询间隔、状态字段、错误结构、结果地址和鉴权下载方式见[视频生成概览](/models/video/overview#视频任务生命周期)。

## 常见错误

- 新接入仍使用旧创建任务接口。
- 参考图超过 `9` 张。
- 参考视频超过 `3` 个，或总时长超过 `15` 秒。
- `duration` 不在 `4` 到 `15` 范围内。
- 新输入格式和兼容层 `operation` 混用导致路由不明确。

## 相关页面

- [Seedance 2.0 系列调用指南](/models/video/seedance-2-0/series-guide)
- [Seedance 2.0 素材库](/models/video/seedance-2-0/material-library)
- [视频生成概览](/models/video/overview)