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

> ## Agent Instructions
> Send API requests to https://api.ttapi.io with the TT-API-KEY header. Midjourney account hosting uses https://hold.ttapi.io. Claude Code uses https://cc.ttapi.io.
> Most generation endpoints are asynchronous. The submit response returns a job id. Poll that product's fetch endpoint, or pass a webhook on the submit request. A fetch call does not start a new generation.
> 1 USD = 100 quota. Check the pricing page for that product before estimating cost.
> This file lists the English docs. Follow every /_llms/ link recursively for the API reference, Chinese, and Russian. Open a page's .md URL for the endpoint schema.

# Seedance 视频生成 API 文档

> 查看 Seedance 视频生成 API 文档，支持全模态参考、编辑视频、延长视频、有声视频、图生视频、文生视频等多种能力。

# Seedance 视频生成 API

这里是 **Seedance 视频生成 API** 总览页，你可以在这里快速了解 Seedance 提供的视频生成能力，并进入具体接口文档。

## Seedance 视频生成 API 可以做什么

Seedance 提供多种视频生成能力，满足不同场景需求：

* **全模态参考**：基于参考图片和视频，融合多模态内容生成新视频
* **编辑视频**：基于参考视频进行编辑，支持删除、替换、修改等操作
* **延长视频**：基于多个参考视频进行延长拼接，生成连续的新视频
* **有声视频-首帧**：基于单张首帧图片生成带同步音频的视频
* **有声视频-首尾帧**：基于首帧和尾帧两张图片生成带同步音频的视频
* **图生视频**：基于单张参考图片生成视频
* **文生视频**：仅通过文本提示词生成视频

## 支持模型

| 模型 | 说明 | 分辨率支持 |
| :- | :- | :- |
| `doubao-seedance-2-5-260628` | Seedance 2.5 | 默认 720p，可选 480p、720p、1080p |
| `doubao-seedance-2-0-260128` | Seedance 2.0 | 默认 720p，可选 480p、720p、1080p、4k |
| `doubao-seedance-2-0-fast-260128` | Seedance 2.0 快速版 | 默认 720p，可选 480p、720p |
| `doubao-seedance-2-0-mini-260615` | Seedance 2.0 轻量版 | 默认 720p，可选 480p、720p |

## 视频生成接口

提交任务后返回 id，通过查询接口获取结果。支持 webhook 回调通知。

| 使用场景 | 接口 | 说明 | 支持模型 |
| :- | :- | :- | :- |
| 全模态参考 | [全模态参考 API](https://docs.ttapi.io/api/cn/seedance/omni-reference.md) | 基于参考图片和视频融合生成 | 全部 4 个模型 |
| 编辑视频 | [编辑视频 API](https://docs.ttapi.io/api/cn/seedance/edit-video.md) | 基于参考视频进行编辑 | 全部 4 个模型 |
| 延长视频 | [延长视频 API](https://docs.ttapi.io/api/cn/seedance/extend-video.md) | 基于多个参考视频延长拼接 | 全部 4 个模型 |
| 有声视频-首帧 | [有声视频-首帧 API](https://docs.ttapi.io/api/cn/seedance/audio-first-frame.md) | 基于首帧图片生成有声视频 | 全部 4 个模型 |
| 有声视频-首尾帧 | [有声视频-首尾帧 API](https://docs.ttapi.io/api/cn/seedance/audio-first-last-frame.md) | 基于首尾帧图片生成有声视频 | 全部 4 个模型 |
| 图生视频 | [图生视频 API](https://docs.ttapi.io/api/cn/seedance/image-to-video.md) | 基于参考图片生成视频 | 全部 4 个模型 |
| 文生视频 | [文生视频 API](https://docs.ttapi.io/api/cn/seedance/text-to-video.md) | 仅通过文本提示词生成视频 | 全部 4 个模型 |
| 查询结果 | [Fetch API](https://docs.ttapi.io/api/cn/seedance/fetch.md) | 查询异步任务状态和结果 | - |

## 推荐接入流程

1. 根据场景选择合适的接口
2. 调用接口提交任务，获取 id
3. 使用 [Fetch API](https://docs.ttapi.io/api/cn/seedance/fetch.md) 轮询查询任务状态，或设置 `hook_url` 接收回调通知
4. 当 `status` 为 `succeeded` 时，从返回结果中获取视频 URL

### 异步任务状态说明

* `queued`：任务待排队
* `running`：任务执行中
* `succeeded`：任务执行成功
* `failed`：任务执行失败
* `cancelled`：任务已取消
* `expired`：任务已过期

## 为什么用 Seedance 视频生成 API

* **多种生成模式**：支持全模态参考、编辑、延长、有声视频、图生视频、文生视频等多种能力
* **高质量输出**：支持多种分辨率（480p / 720p / 1080p / 4k）和宽高比，Seedance 2.5 的 1080p 和 Seedance 2.0 的 4k 采用 10bit 位深与 H.265/HEVC 编码
* **同步音频**：支持生成带同步音频的视频
* **灵活控制**：支持自定义时长、水印、输出格式等参数
* **统一网关**：使用 TTAPI 统一的 API 网关和鉴权机制


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