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

# Seedance 系列介绍

> 了解 Seedance 系列在 AIOAGI 中的视频生成、图生视频和多模态参考生视频能力。

`Seedance` 系列是豆包视频生成模型系列。它适合文生视频、图生视频、首尾帧控制、多模态参考生视频、产品展示、商业广告、短视频脚本验证和动态创意生产。

AIOAGI 将 Seedance、Seedream、GPT、Claude、DeepSeek、Gemini、Qwen 和 Vibe Coding 等模型聚合到统一平台。你可以使用 AIOAGI API Key，通过视频任务接口创建异步任务，再轮询任务结果。模型名称、价格、分辨率、时长、音频支持和上线状态可能变化，请以 **控制台** 和 **开发者指南** 为准。

<Warning>
  视频生成通常比文本和图片任务耗时更长。上线生产前，请确认 Token 组支持目标 Seedance 模型，并为任务轮询、超时、失败重试和额度控制做好设计。
</Warning>

## 系列定位

<CardGroup cols={2}>
  <Card title="Seedance 2.0" icon="film">
    新一代多模态视频生成模型。支持文本、图片、视频和音频参考输入，适合商业广告、影视制作、社交媒体营销和高稳定角色特征场景。
  </Card>

  <Card title="Seedance 1.5 pro" icon="video">
    适合需要音画同步、多人多语言对白、环境音、动作音和影视级叙事效果的高阶创作。
  </Card>

  <Card title="文生视频" icon="file-lines">
    通过 `content` 中的 `text` 提示词生成视频。适合广告创意、镜头草案、动态海报和短视频脚本验证。
  </Card>

  <Card title="图生视频和参考生视频" icon="images">
    通过 `image_url`、`video_url`、`audio_url` 和 `role` 指定首帧、尾帧或参考素材。
  </Card>
</CardGroup>

## 当前参考模型

| 模型 ID                            | 主要能力                       | 计费提示           |
| -------------------------------- | -------------------------- | -------------- |
| `doubao-seedance-2-0-260128`     | 文生视频、图生视频、多模态参考生视频、有声或无声视频 | 价格和开放状态以控制台为准。 |
| `doubao-seedance-1-5-pro-251215` | 文生视频、图生视频、首尾帧、音画同步、样片模式    | 价格和开放状态以控制台为准。 |

<Info>
  本页只说明公开接入方式和常见参数。模型 ID、价格、折扣、时长规格和模型开放状态可能变化，请在 **控制台** 或 **开发者指南** 中核对后再上线生产调用。
</Info>

## 适合场景

* **营销短片**：快速生成商品展示、活动预告、信息流广告和创意分镜。
* **产品演示**：把静态产品图转成动态镜头，验证视觉方向。
* **影视和漫剧草案**：生成镜头片段，辅助评审角色、光影、节奏和叙事。
* **多模态改编**：使用参考图、参考视频或参考音频生成新的目标视频。
* **批量生产**：用异步任务队列提交多条视频，并统一轮询结果。

## AIOAGI 使用方法

<Steps>
  <Step title="创建 API Key">
    登录 AIOAGI 控制台，在 **令牌** 或 **API Key** 页面创建密钥。视频任务建议单独使用 Token 组，便于额度控制和成本追踪。
  </Step>

  <Step title="确认模型权限">
    在 **控制台**、**开发者指南** 或 `GET /models` 返回结果中确认目标 Seedance 模型可用。模型别名以控制台展示为准。
  </Step>

  <Step title="配置视频任务端点">
    在服务端保存 API Key 和 base URL。常用端点为 `https://api.aiearth.dev/v1`，也可以按网络情况使用 `https://api.aiearth.vip/v1`。
  </Step>

  <Step title="提交异步任务">
    使用视频任务接口创建任务。请求体按官方 Seedance 参数组织：用 `content` 数组传入文本、图片、视频或音频，用 `ratio`、`duration`、`resolution` 和 `generate_audio` 控制输出规格。
  </Step>

  <Step title="轮询并保存结果">
    创建成功后读取响应中的 `id`，再查询任务状态。任务进入 `succeeded` 后，读取响应中的视频 URL 并保存到你的业务存储。
  </Step>
</Steps>

## API 调用

具体请求代码、参数表、任务轮询和返回说明请查看 [Seedance 系列 API](/api-reference/endpoint/seedance.mdx)。模型介绍页只保留能力、选型和使用流程说明。

## 核心参数

| 参数                        | 类型        | 说明                                                                                                 |
| ------------------------- | --------- | -------------------------------------------------------------------------------------------------- |
| `model`                   | `string`  | 必填。Seedance 模型 ID，例如 `doubao-seedance-2-0-260128`。                                                 |
| `content`                 | `array`   | 必填。输入给模型的内容数组。支持 `text`、`image_url`、`video_url`、`audio_url` 和 `draft_task`。                        |
| `content[].type`          | `string`  | 内容类型。文本使用 `text`，图片使用 `image_url`，视频使用 `video_url`，音频使用 `audio_url`。                               |
| `content[].text`          | `string`  | 当 `type` 为 `text` 时使用。用于描述期望生成的视频。                                                                 |
| `content[].image_url.url` | `string`  | 图片 URL、`data:image/...;base64,...` 或 `asset://` 素材 ID。                                             |
| `content[].video_url.url` | `string`  | 视频 URL 或 `asset://` 素材 ID。Seedance 2.0 系列支持参考视频输入。                                                 |
| `content[].audio_url.url` | `string`  | 音频 URL、`data:audio/...;base64,...` 或 `asset://` 素材 ID。Seedance 2.0 系列支持参考音频输入。                     |
| `content[].role`          | `string`  | 图片、视频或音频用途。常见值包括 `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio`。 |
| `ratio`                   | `string`  | 生成视频宽高比。常见值包括 `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`。                                   |
| `duration`                | `integer` | 生成视频时长，单位为秒。Seedance 2.0 系列常见范围为 `4` 到 `15`，也可按模型支持情况设置为 `-1` 自动选择。                                |
| `resolution`              | `string`  | 生成视频分辨率。常见值包括 `480p`、`720p`、`1080p`、`4k`。不同模型支持范围不同。                                               |
| `generate_audio`          | `boolean` | 是否生成同步音频。Seedance 2.0 系列和 Seedance 1.5 Pro 支持。                                                     |
| `callback_url`            | `string`  | 可选。任务状态变化时接收回调通知。                                                                                  |
| `return_last_frame`       | `boolean` | 可选。是否在查询结果中返回生成视频的尾帧图像。                                                                            |
| `watermark`               | `boolean` | 可选。是否添加 `AI 生成` 水印。                                                                                |

<Warning>
  不要使用第三方自定义字段来调用 Seedance。文生视频、图生视频和参考生视频都应通过官方 `content` 数组表达输入，输出规格直接使用 `ratio`、`duration`、`resolution` 和 `generate_audio`。
</Warning>

## 输入组合

* 文生视频：传入一个 `type: "text"` 的 `content` 项。
* 图生视频首帧：传入文本和一张 `role: "first_frame"` 的图片。
* 图生视频首尾帧：传入文本、一张 `first_frame` 图片和一张 `last_frame` 图片。
* Seedance 2.0 多模态参考生视频：可传入参考图片、参考视频和参考音频。不可只传音频，至少需要包含一项参考图片或参考视频。
* 样片任务：Seedance 1.5 Pro 可通过 `draft_task` 基于样片任务 ID 生成正式视频。是否开放请以控制台和开发者指南为准。

## 提示词建议

* 写清楚主体、镜头运动、画幅、节奏、风格和时长。
* 图生视频要说明首帧到尾帧之间的变化，不要只写抽象风格词。
* 多模态参考生视频要说明哪些元素需要保持一致，例如人物、产品、配色、场景、动作或声音。
* 对生产任务固定 `ratio`、`duration` 和 `resolution`，减少不可控变化。
* 保存成功样例和失败样例，沉淀为后续批量生成的提示词模板。

## 排障建议

* 遇到 `401`，检查 API Key 和 `Authorization` 请求头。
* 遇到 `403`，检查账户余额、Token 组额度和模型权限。
* 遇到 `404` 或 `model_not_found`，核对 base URL、模型 ID 和任务 ID。
* 遇到参数错误，先检查 `content` 结构、`role` 取值、`ratio`、`duration`、`resolution` 和当前模型是否匹配。
* 遇到 `429`，降低提交并发和轮询频率，并加入指数退避。
* 遇到 `500` 或 `502`，记录任务 ID 和时间窗口，稍后重试或联系服务支持。

<Tip>
  视频任务适合用队列管理。建议把提交、轮询、下载、失败重试和费用记录拆开，避免单个请求阻塞业务主流程。
</Tip>