Seedance 2.5 经济版
Seedance 2.5 经济版作为大规模批量处理与降低算力成本的补充通道，该渠道在连通状态下具备极其稳定的运动质量与声画同步表现。受限于节点算力资源紧张，整体可用性维持在 60%~70% 左右（每日高空闲流畅窗口约 6~7 小时，如遇到堵塞可稍后重试）。强烈建议开发者通过 API 接口实施自动化轮询与重试调用，以最低成本实现矩阵式视频生产，广泛适用于跨境电商商品视频、批量短视频特效预演与自动化广告素材流水线。
Seedance 2.5 Economy
Seedance 2.5 Economy 是一款注重生成效率和成本控制的视频生成模型。它可根据文本提示词生成 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。任务处理中，result 为 []；当 status 为 SUCCEEDED 时，result 包含生成的资源列表，并且响应中包含 costUSD。以下两个步骤需要使用同一个 task_id。
1. 提交任务
向任务提交接口发送视频生成请求。提示词中的 @Image1、@Video1 和 @Audio1 分别引用对应数组中的第一个资源。
2. 查询任务结果（轮询）
使用提交任务时返回的 task_id 查询任务进度。您可以重复调用该接口，直至任务进入终态。
响应包含 status 和 result。任务处理中，result 为 []；当 status 为 SUCCEEDED 时，result 为生成资源数组，并且响应中包含 costUSD；当 status 为 FAILED 时，表示任务失败。
输入参数
提交任务 - 输入参数
任务提交请求体支持以下参数。
总计：8；必填：4；可选：4
用于描述待生成视频的文本提示词，支持多行文本。
使用参考资源时，通过 @ImageN、@VideoN 或 @AudioN 引用对应数组中的资源，其中 N 从 1 开始。例如，@Image1 表示 images 数组中的第一个图片 URL。
用作图片参考的公开可访问图片 URL 列表。通过提示词中的 @Image1、@Image2 等标记引用。
用作视频参考的公开可访问视频 URL 列表。通过提示词中的 @Video1、@Video2 等标记引用。
参考视频时长会计入计费时长。总费用按“单价 ×（输出视频时长 + 参考视频时长）”计算。
用作音频参考的公开可访问音频 URL 列表。通过提示词中的 @Audio1、@Audio2 等标记引用。
输出视频的分辨率。
输出视频的宽高比。设置为 adaptive 时，模型会根据输入内容自动选择合适的宽高比。
输出视频的时长，单位为秒。接受 4 至 30 的整数，也可以设置为 -1，由模型自动选择时长。
Min: 4 Max: 30
是否在输出视频中添加“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-economy
> Seedance 2.5 Economy 是一款注重生成效率和成本控制的视频生成模型，支持文本以及图片、视频和音频参考内容。
## 概述
使用 iCreat 的二段式异步任务 API 提交视频生成请求，然后轮询任务结果接口。任务成功后，从 `result` 中获取视频资源 URL。成功响应中还会包含 `costUSD`。
使用参考视频时，参考视频时长会计入计费时长。总费用按“单价 ×（输出视频时长 + 参考视频时长）”计算。
## API 信息
- **Base URL**：`https://api.icreat.ai`
- **任务提交接口（POST）**：`/v1/task/submit/bytedance/seedance-2-5-economy`
- **任务结果查询接口（POST）**：`/v1/task/result`
- **模型 ID**：`bytedance/seedance-2-5-economy`
- **认证方式**：`Authorization: Bearer ${ICREAT_API_KEY}`
## 调用流程
1. **提交任务**：向任务提交接口发送 POST 请求，并在请求体中传入生成参数。接口返回 `{ "task_id": "..." }`。
2. **查询结果**：向 `/v1/task/result` 发送 POST 请求，请求体为 `{ "task_id": "..." }`。
3. 任务处理中，`result` 为 `[]`，需要继续轮询。
4. 当状态为 `SUCCEEDED` 时，从 `type` 为 `Video` 的资源中读取 `url` 或 `download_url`。
5. 当状态为 `FAILED` 时停止轮询并检查请求参数和参考资源。
## 任务提交请求示例
```json
{
"prompt": "参考 @Image1 的主体、@Video1 的运镜和 @Audio1 的节奏生成视频",
"images": [
"https://example.com/reference.png"
],
"videos": [
"https://example.com/reference.mp4"
],
"audios": [
"https://example.com/reference.mp3"
],
"resolution": "480p",
"ratio": "9:16",
"duration": 4,
"watermark": true
}
```
## 输入参数说明
- `prompt`（必填）：视频生成提示词，支持多行文本。使用参考资源时，通过 `@ImageN`、`@VideoN` 和 `@AudioN` 引用对应数组中的资源，序号从 `1` 开始。
- `images`（可选）：公开可访问的图片 URL 列表，通过 `@Image1`、`@Image2` 等标记引用。
- `videos`（可选）：公开可访问的视频 URL 列表，通过 `@Video1`、`@Video2` 等标记引用。参考视频时长会计入计费时长。
- `audios`（可选）：公开可访问的音频 URL 列表，通过 `@Audio1`、`@Audio2` 等标记引用。
- `resolution`（必填）：输出视频分辨率，支持 `480p`、`720p` 和 `1080p`。
- `ratio`（必填）：输出视频宽高比，支持 `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9` 和 `adaptive`。
- `duration`（必填）：输出视频时长。接受 `4` 至 `30` 的整数，也可以设置为 `-1`，由模型自动选择时长。默认值为 `5`。
- `watermark`（可选）：是否在输出视频中添加“AI Generated”水印。
## 计费说明
- 总费用 = 单价 ×（输出视频时长 + 参考视频时长）。
- 未提供参考视频时，仅按输出视频时长计费。
- 图片和音频参考内容不计入视频时长。
## 输出说明
- 轮询任务时需要检查 `status`。任务处理中，`result` 为 `[]`。
- 任务成功后，响应格式为 `result: [{ "type": "Video", "url": "...", "download_url": "..." }]`，并且包含 `costUSD`。
## 注意事项
- 提交任务和查询任务结果时必须使用同一个 `task_id`。
- `FAILED` 是终态。任务失败时，请检查请求参数和参考资源。
- 参考资源数组的顺序必须与提示词中的引用序号对应。