SD2.5 30s经济版按次

Seedance 2.5 30s 经济版（按次）是高性价比长视频生成部署渠道。该渠道将生成时长固定为 30 秒，并采用标准化的宽高比与分辨率配置，通过简化参数调优门槛显著降低了单条视频的合成成本。模型节点可用性维持在约 70%，平均任务排队渲染耗时为 1,500–2,000 秒（约 25–33 分钟）。非常适合对参数灵活性与即时生成时效要求较低、但追求极致低成本的自动化任务，如短视频矩阵建库、跨境电商商品展示后台异步排队渲染以及大批量视频素材生成场景。

Seedance 2.5 Economy 30秒版

Seedance 2.5 Economy 30秒版是一款专注于生成效率和成本控制的视频生成模型。它可以根据文本提示词生成固定时长为30秒的视频，支持多种宽高比，以及图片、视频和音频参考。

使用参考视频时，参考视频的时长将计入计费时长。总费用的计算方式为：“单价 ×（输出视频时长 + 参考视频时长）”。

基础 URL

https://api.icreat.ai

身份认证

所有 API 请求都需要使用 API 密钥进行身份认证。你可以从控制台获取 API 密钥。

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 密钥

切勿在客户端代码或公共代码仓库中暴露 API 密钥。请使用环境变量或后端代理。

代码示例

视频生成采用两步异步工作流：首先提交任务并获取 task_id，然后轮询任务结果接口以查询处理进度。

响应中包含 status 和 result。任务处理期间，result 为 []。当 status 为 SUCCEEDED 时，result 中会包含生成的资源列表，同时响应中还会包含 costUSD。提交任务和查询结果时必须使用同一个 task_id。

1. 提交任务

向任务提交接口发送视频生成请求。在提示词中使用 @Image1、@Video1 和 @Audio1 引用对应数组中的第一个资源。

POST/v1/task/submit/bytedance/seedance-2-5-economy-30s

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/submit/bytedance/seedance-2-5-economy-30s" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "使用 @Image1 中的主体、@Video1 中的镜头运动和 @Audio1 中的节奏生成视频",
    "images": [
      "https://example.com/reference.png"
    ],
    "videos": [
      "https://example.com/reference.mp4"
    ],
    "audios": [
      "https://example.com/reference.mp3"
    ],
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 30
  }'

2. 查询任务结果（轮询）

使用提交任务时返回的 task_id 查询处理进度。你可以重复调用此接口，直到任务进入最终状态。

响应中包含 status 和 result。任务处理期间，result 为 []。当 status 为 SUCCEEDED 时，result 中会包含生成的资源数组，同时响应中还会包含 costUSD。当 status 为 FAILED 时，表示任务执行失败。

POST/v1/task/result

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/result" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task-xxx"}'

输入参数

提交任务 - 输入参数

任务提交请求体支持以下参数。

总计：8个；必填：4个；可选：4个

promptstring必填

描述待生成视频的文本提示词，支持多行文本。

使用参考资源时，请通过 @ImageN、@VideoN 或 @AudioN 引用对应数组中的资源，其中 N 从 1 开始。例如，@Image1 表示 images 数组中的第一个图片 URL。

imagesstring[]

用于图片参考的公开可访问图片 URL 列表。请在提示词中使用 @Image1、@Image2 等标记引用这些图片。

videosstring[]

用于视频参考的公开可访问视频 URL 列表。请在提示词中使用 @Video1、@Video2 等标记引用这些视频。

参考视频的时长将计入计费时长。总费用的计算方式为：“单价 ×（输出视频时长 + 参考视频时长）”。

audiosstring[]

用于音频参考的公开可访问音频 URL 列表。请在提示词中使用 @Audio1、@Audio2 等标记引用这些音频。

resolutionstring必填

输出视频的分辨率。

720p

ratiostring必填

输出视频的宽高比。当设置为 `` 时，模型会根据输入内容自动选择合适的宽高比。

16:91:19:16

durationinteger必填

输出视频的时长，单位为秒。此模型仅支持固定的 30 秒时长。

值：30

默认值"30"

watermarkboolean

是否在输出视频中添加“AI 生成”水印。

查询任务结果 - 输入参数

总计：1个；必填：1个；可选：0个

task_idstring必填

任务提交接口返回的任务 ID。

输出参数

提交任务 - 输出参数

总计：1个

task_idstring

任务提交接口返回的任务 ID。

查询任务结果 - 输出参数

总计：数量不固定

statusstring

当前任务状态。任务成功前，result 通常为 []。当状态为 SUCCEEDED 时，result 中会包含生成的资源，同时响应中还会包含 costUSD。

SUBMITTEDSUCCEEDEDFAILED

resultarray[object]

生成的资源列表。任务处理期间或尚未成功时，此字段为 []。任务成功后，其中会包含资源对象数组。

costUSDnumber

任务费用，单位为美元。此字段仅在 status 为 SUCCEEDED 时返回。

LLM 友好提示词

以下是适用于 LLM 的 Markdown 提示词，可复制到 Cursor、ChatGPT 或其他 AI 助手中，帮助它们理解该模型的 API 集成方式、工作流程和关键参数。点击“复制 LLM 提示词”按钮，或复制以下代码块中的完整内容。

# bytedance/seedance-2-5-economy-30s

> Seedance 2.5 Economy 30秒版是一款专注于生成效率和成本控制的视频生成模型。它支持文本提示词以及图片、视频和音频参考，并生成固定时长为30秒的视频。

## 概述

使用 iCreat 的两步异步任务 API 提交视频生成请求，然后轮询任务结果接口。任务成功后，从 `result` 中获取视频资源 URL。成功响应中还会包含 `costUSD`。

使用参考视频时，参考视频的时长将计入计费时长。总费用的计算方式为：“单价 ×（输出视频时长 + 参考视频时长）”。

## API 信息

- **基础 URL**：`https://api.icreat.ai`
- **任务提交接口（POST）**：`/v1/task/submit/bytedance/seedance-2-5-economy-30s`
- **任务结果接口（POST）**：`/v1/task/result`
- **模型 ID**：`bytedance/seedance-2-5-economy-30s`
- **身份认证**：`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` 时，停止轮询并检查请求参数和参考资源。

## 输入参数

- `prompt`（必填）：视频生成提示词，支持多行文本。使用 `@ImageN`、`@VideoN` 和 `@AudioN` 引用对应数组中的资源，索引从 `1` 开始。
- `images`（可选）：公开可访问的图片 URL 列表。使用 `@Image1`、`@Image2` 等标记引用。
- `videos`（可选）：公开可访问的视频 URL 列表。使用 `@Video1`、`@Video2` 等标记引用。参考视频时长将计入计费时长。
- `audios`（可选）：公开可访问的音频 URL 列表。使用 `@Audio1`、`@Audio2` 等标记引用。
- `resolution`（必填）：输出视频分辨率。支持 `720p` 和 ``。
- `ratio`（必填）：输出视频宽高比。支持 `16:9`、``、`1:1`、`9:16`。
- `duration`（必填）：输出视频时长。此模型仅支持固定的 `30` 秒时长。
- `watermark`（可选）：是否在输出视频中添加“AI 生成”水印。

## 计费说明

- 总费用 = 单价 ×（30秒输出时长）。
- 未提供参考视频时，仅对30秒的输出视频时长计费。
- 图片和音频参考不计入视频时长。

## 输出

- 轮询任务时检查 `status`。任务处理期间，`result` 为 `[]`。
- 任务成功后，响应格式为 `result: [{ "type": "Video", "url": "...", "download_url": "..." }]`，同时还会包含 `costUSD`。

## 注意事项

- 提交任务和查询结果时必须使用同一个 `task_id`。
- `FAILED` 是最终状态。任务失败时，请检查请求参数和参考资源。
- 输出视频时长固定为30秒。
- 支持的分辨率为 `720p` 和 ``。
- 参考资源数组的顺序必须与提示词中使用的引用索引一致。