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

# Seedance 2.5 说明

> model: seedance-2-5，与 Seedance 2.0 的接口、参数差异

## 简介

Seedance 2.5（`model: "seedance-2-5"`）与 Seedance 2.0 共用同一套接口（Base URL、鉴权、素材库、任务查询、响应结构均相同），只需在 [创建视频生成任务](/cn/api-reference/endpoint/seedance-2.0/create-video-generation) 时把 `model` 换成 `seedance-2-5` 即可调用。本页只列出 **2.5 相对 2.0 的差异**；未提及的部分（鉴权、素材库、轮询、错误码等）均与 2.0 完全一致，直接参考对应文档：

* [创建视频生成任务](/cn/api-reference/endpoint/seedance-2.0/create-video-generation)（基础参数、`content` 数组结构、互斥规则）
* [查询视频生成任务](/cn/api-reference/endpoint/seedance-2.0/get-video-generation)
* [创建素材组](/cn/api-reference/endpoint/seedance-2.0/create-asset-group) / [创建素材](/cn/api-reference/endpoint/seedance-2.0/create-asset)
* [查询审核拦截原因](/cn/api-reference/endpoint/seedance-2.0/get-moderation-result)

## 主要差异一览

| 项目                     | Seedance 2.0                     | Seedance 2.5              |
| ---------------------- | -------------------------------- | ------------------------- |
| `duration`             | `-1` 或 `4~15` 秒                  | `-1` 或 `4~30` 秒           |
| 参考图片 `reference_image` | 最多 9 张                           | 最多 30 张                   |
| 参考视频 `reference_video` | 最多 3 个，总时长 ≤ 15 秒                | 最多 10 个                   |
| 参考音频 `reference_audio` | 最多 3 段                           | 最多 10 段                   |
| 视频编辑 / 视频延长            | 不支持                              | 支持，见下方「规则」                |
| `output_format`        | 固定 `mp4`                         | 新增 `mov` 可选               |
| `resolution`（当前已开放）    | `480p` / `720p` / `1080p` / `4K` | `480p` / `720p` / `1080p` |

<Note>
  参考素材数量上限、时长上限为 Seedance 2.5 上游模型能力，详见 [Dreamina Seedance 2.5 tutorial](https://docs.byteplus.com/en/docs/ModelArk/2607688)。目前已跟随上游放开 `duration` 与参考素材数量限制；`resolution` 计费档位以本页表格及实际下单页为准。
</Note>

## 规则

Seedance 2.5 不提供显式的任务类型参数，而是根据 `content` 中媒体素材的 `role` 与提示词表达的意图，自动判定本次请求属于下表中的哪种任务；不同任务类型下，`ratio`、`duration` 的取值范围也不同：

| 任务类型      | 触发条件                                                                     | `ratio`           | `duration`    |
| --------- | ------------------------------------------------------------------------ | ----------------- | ------------- |
| 文生视频      | 不包含任何参考素材，仅文本提示词                                                         | 指定宽高比或 `adaptive` | `-1` 或 `4~30` |
| 参考生视频     | 提供 `reference_image`、`reference_video` 或 `reference_audio`，且提示词不含编辑/延长意图 | 指定宽高比或 `adaptive` | `-1` 或 `4~30` |
| 视频编辑      | 提供参考素材，且提示词包含增加、删除、替换、修改、重绘或修复等编辑意图                                      | 必须为 `adaptive`    | 必须为 `-1`      |
| 视频延长      | 提供参考素材，且提示词包含向前/向后延长、延续或续写等意图                                            | 必须为 `adaptive`    | `-1` 或 `4~30` |
| 首帧/首尾帧生视频 | 提供 `first_frame` 作为图片输入，可再搭配 `last_frame`                                | 必须为 `adaptive`    | `-1` 或 `4~30` |

## 请求示例（标准文生视频 / 图生视频）

与 2.0 用法完全一致，仅需替换 `model`：

```bash theme={null}
curl -X POST "https://api.gravitex.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "content": [
      {"type": "text", "text": "黄金时刻，无人机航拍连绵山脉，云海翻涌"}
    ],
    "duration": 20,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'
```

参数说明、`content` 数组结构、素材 `asset://` 映射规则等，参见 [创建视频生成任务](/cn/api-reference/endpoint/seedance-2.0/create-video-generation)。

下一步：[查询视频生成任务](/cn/api-reference/endpoint/seedance-2.0/get-video-generation)