Seedance 2.5
Seedance 2.5 是一款基于参考图像、视频和音频进行多模态视频生成的工具，并支持视频编辑与扩展功能。
Seedance 2.5
Seedance 2.5 是字节跳动的多模态视频生成模型，支持参考图片、视频与音频生成视频，单次最长 30 秒，支持视频编辑、延展与 web_search 工具。输出分辨率 480p 或 720p，时长 4–30 秒。
Base URL
https://api.icreat.ai认证
所有 API 请求需要通过 API Key 进行认证。您可以在控制台获取 API Key。
export ICREAT_API_KEY="your-api-key-here"HTTP 请求头
import os
API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer " + API_KEY,
}保护好您的 API Key
切勿在客户端代码或公开仓库中暴露您的 API Key。请使用环境变量或后端代理。
代码示例
图片/视频生成采用二段式异步调用：先提交任务获取 task_id，再通过查询任务结果接口轮询进度；响应含 status 与 result（处理中为 []，SUCCEEDED 时 result 为资源列表且响应含 costUSD）。以下示例使用同一 task_id 串联两个步骤。
1. 提交任务
向提交接口发送生成请求。成功后响应体返回 task_id，请保存该 ID 用于查询任务结果（可轮询直至终态）。
2. 查询任务结果（轮询）
使用提交步骤返回的 task_id 查询任务进度（可重复调用直至终态）。响应含 status 与 result：非终态或处理中时 result 为 []；SUCCEEDED 时 result 为资源数组且响应含 costUSD；FAILED 表示任务失败。
输入参数
提交任务 — 输入参数
以下参数在提交任务请求体中被接受。API 采用多模态输入结构；content 为必填数组，支持文本、图片、视频与音频参考的任意组合。
总计: 7 必填: 1 可选: 6
多模态内容数组。每一项表示一条文本提示词或一条参考媒体资源。
是否为输出视频生成音频。
输出宽高比。设为 adaptive 时，模型会根据输入自动选择最合适的宽高比。
输出分辨率。
视频时长（秒）。可填 4–30 的整数，或 -1 由模型自动选择时长。
是否在输出视频上添加「AI Generated」水印。
要使用的工具列表。
查询任务结果 — 输入参数
总计: 1 必填: 1 可选: 0
提交任务接口返回的任务 ID。
输出参数
提交任务 — 输出参数
总计: 1
异步任务的唯一标识。使用此 ID 调用查询任务结果接口（可轮询直到终态）。
查询任务结果 — 输出参数
总计: 可变
当前任务状态。非成功时 result 通常为 []；SUCCEEDED 时 result 含资源项且响应含 costUSD。
生成资源列表。处理中或未成功时为 []；成功时为对象数组。
任务费用（美元），仅在 status 为 SUCCEEDED 时出现。
LLM友好的提示词
以下是一段 LLM 友好的 Markdown 提示词，可复制到 Cursor、ChatGPT 等 AI 助手中，帮助 AI 理解本模型的 API 接入方式、调用流程与关键参数。点击「复制LLM提示词」按钮或下方代码块均可复制全文。
# bytedance/seedance-2-5
> Seedance 2.5 是字节跳动的多模态视频生成模型，支持参考图片、视频与音频生成视频，单次最长 30 秒，支持视频编辑、延展与 `web_search` 工具。
## 概述
通过 iCreat 二段式异步任务 API 提交生成请求，再轮询查询任务结果接口，成功时从 `result` 获取视频资源 URL（含 `costUSD`）。
## API 信息
- **Base URL**：`https://api.icreat.ai`
- **Submit endpoint (POST)**：`/v1/task/submit/bytedance/seedance-2-5`
- **Query result endpoint (POST)**：`/v1/task/result`
- **Model ID**：`bytedance/seedance-2-5`
- **认证**：`Authorization: Bearer ${ICREAT_API_KEY}`
## 调用流程
1. **Submit**：POST submit 路径，Body 见输入要点；响应 `{ "task_id": "..." }`
2. **Query result**：POST `/v1/task/result`，Body `{ "task_id": "..." }`；响应含 `status` 与 `result`（处理中 `result` 为 `[]`）；`SUCCEEDED` 时 `result` 为资源数组且含 `costUSD`，`type` 为 `Video` 时读取 `url` 或 `download_url`
### 输入要点
- 请求体以 `content` 多模态数组为核心，配合分辨率/时长等参数
- `video_url`（可选）：当 `type` 为 `video_url` 时必填。参考视频 URL 对象。
- `audio_url`（可选）：当 `type` 为 `audio_url` 时必填。参考音频 URL 对象。
- `role`（可选）：媒体类型（`image_url`、`video_url`、`audio_url`）必填。指定参考媒体的角色。
- `need_review`（可选）：是否将参考内容提交官方审核。当参考内容含人脸或版权 IP 时请设为 `true`，否则生成很可能失败。
- `generate_audio`（可选）：是否为输出视频生成音频。
- `ratio`（可选）：输出宽高比。设为 `adaptive` 时，模型会根据输入自动选择最合适的宽高比。
- `resolution`（可选）：输出分辨率。
- `duration`（可选）：视频时长（秒）。可填 4–30 的整数，或 `-1` 由模型自动选择时长。
- `watermark`（可选）：是否在输出视频上添加「AI Generated」水印。
- `tools`（可选）：要使用的工具列表。
### 输出要点
- 轮询：看 `status`；`result` 处理中为 `[]`
- 成功：`result` 为 `[{ "type": "Video", "url": "...", "download_url": "..." }]`，并含 `costUSD`
## 注意事项
- 两步须用同一 `task_id` 串联；处理中 `result` 为 `[]`，需继续轮询
- `FAILED` 为终态，需排查请求参数或参考内容