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

# Seedance 2.0 概览

> 豆包 Seedance 2.0 视频生成与素材库

## 简介

Seedance 2.0 支持文生视频、图生视频（首帧/首尾帧）、多模态参考生成与面部一致性素材库。通过 tennda AI 网关统一调用，Base URL：`https://api.tennda.ai`。

| 模型 ID               | 说明         | 分辨率                          |
| ------------------- | ---------- | ---------------------------- |
| `seedance-2-0`      | 标准版，适合正式生产 | `480p`、`720p`、`1080p`        |
| `seedance-2-0-fast` | 快速版，适合快速迭代 | `480p`、`720p`（**不支持 1080p**） |

## 认证

所有接口：`Authorization: Bearer sk-xxxxxxxxxx`，`Content-Type: application/json`。

<Note>
  `asset://` 须按素材 `asset_type` 映射到 `image_url` / `video_url` / `audio_url`，不能全部塞进 `image_url`。素材仅接受公网 **https URL** 创建，不支持 Base64 / Data URI 直传。
</Note>

## 素材库类型

| 库类型   | `group_type`    | 创建方式                                                                                      |
| ----- | --------------- | ----------------------------------------------------------------------------------------- |
| 虚拟素材库 | `aigc`          | [创建素材组](/cn/api-reference/endpoint/seedance-2.0/create-asset-group)                       |
| 真人素材库 | `liveness_face` | [创建素材组（真人）](/cn/api-reference/endpoint/seedance-2.0/create-visual-validate-session) H5 核验 |

推荐流程：创建素材组 → [创建素材](/cn/api-reference/endpoint/seedance-2.0/create-asset) → 轮询至 `status: active` → [创建视频生成任务](/cn/api-reference/endpoint/seedance-2.0/create-video-generation) → [查询任务](/cn/api-reference/endpoint/seedance-2.0/get-video-generation)。

## 接口目录

### 视频生成

<CardGroup cols={2}>
  <Card title="创建视频生成任务" icon="upload" href="/cn/api-reference/endpoint/seedance-2.0/create-video-generation">
    POST /v1/video/generations
  </Card>

  <Card title="查询视频生成任务" icon="search" href="/cn/api-reference/endpoint/seedance-2.0/get-video-generation">
    GET /v1/video/generations/{task_id}
  </Card>

  <Card title="查询审核拦截原因" icon="shield" href="/cn/api-reference/endpoint/seedance-2.0/get-moderation-result">
    GET /v1/video/generations/moderation-result/{task_id}
  </Card>
</CardGroup>

### 素材库（虚拟 aigc）

<CardGroup cols={2}>
  <Card title="创建素材组" icon="folder-plus" href="/cn/api-reference/endpoint/seedance-2.0/create-asset-group">
    POST /v1/asset-groups
  </Card>

  <Card title="列出素材组" icon="folders" href="/cn/api-reference/endpoint/seedance-2.0/list-asset-groups">
    GET /v1/asset-groups
  </Card>

  <Card title="删除素材组" icon="trash" href="/cn/api-reference/endpoint/seedance-2.0/delete-asset-group">
    DELETE /v1/asset-groups/{group_id}
  </Card>

  <Card title="创建素材" icon="file-plus" href="/cn/api-reference/endpoint/seedance-2.0/create-asset">
    POST /v1/assets
  </Card>

  <Card title="列出素材" icon="list" href="/cn/api-reference/endpoint/seedance-2.0/list-assets">
    GET /v1/assets
  </Card>

  <Card title="查询单个素材" icon="file" href="/cn/api-reference/endpoint/seedance-2.0/get-asset">
    GET /v1/assets/{virtual_id}
  </Card>

  <Card title="删除素材" icon="file-minus" href="/cn/api-reference/endpoint/seedance-2.0/delete-asset">
    DELETE /v1/assets/{virtual_id}
  </Card>
</CardGroup>

### 真人素材库（liveness\_face）

<CardGroup cols={2}>
  <Card title="创建素材组（真人）" icon="user-check" href="/cn/api-reference/endpoint/seedance-2.0/create-visual-validate-session">
    POST /v1/visual-validate/session
  </Card>
</CardGroup>

<Note>
  `POST /v1/visual-validate/result` 仅供 H5 回调页内部使用，业务侧无需调用。
</Note>

## 推荐流程

1. （可选）创建素材组 → 创建素材 → 轮询至 `status: active`（通常 1\~3 分钟）
2. `POST /v1/video/generations` 提交任务
3. `GET /v1/video/generations/{task_id}` 每约 5 秒轮询至 `completed`（通常 30\~120 秒）
4. 若 `failed` 且需排查审核，调用 [查询审核拦截原因](/cn/api-reference/endpoint/seedance-2.0/get-moderation-result)

统一视频入口说明亦见 [提交视频任务](/cn/api-reference/endpoint/submit-video-task)。

## 常见 HTTP 状态码

| 状态码   | 含义         |
| ----- | ---------- |
| `400` | 参数错误       |
| `401` | API Key 无效 |
| `402` | 余额不足       |
| `429` | 请求过频       |
| `502` | 上游服务错误     |

网关校验失败返回 `error.type: invalid_request_error`；到达火山方舟后的错误会透传 `error.code`（如 `InvalidParameter`）与 `param` 字段路径。