Seedance 2.0 经济版

Seedance 2.0 经济版作为大规模批处理与降低算力成本的补充通道，计费规则极具优势——仅按实际生成的输出秒数扣费，输入视频完全不计费。该渠道在连通状态下具备极其稳定的运动质量与声画同步表现。受限于节点算力资源紧张，整体可用性维持在 60%~70% 左右（每日高空闲流畅窗口约 6~7 小时，如遇到堵塞可稍后重试）。强烈建议开发者通过 API 接口实施自动化轮询与重试调用，以最低成本实现矩阵式视频生产，广泛适用于跨境电商商品视频、批量短视频特效预演与自动化广告素材流水线。

Seedance 2.0 Economy

Seedance 2.0 Economy 提供最高的画面质量。它可根据文本提示词生成 4 至 15 秒的视频，并支持多种宽高比以及图片、视频和音频参考内容。

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. 提交任务

向任务提交接口发送视频生成请求。

POST/v1/task/submit/bytedance/seedance-2-0-economy

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/bytedance/seedance-2-0-economy \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "示例多行\n文本 @图片1",
    "images": [
      "https://example.com/example.png"
    ],
    "videos": [
      "https://example.com/example.png"
    ],
    "audios": [
      "https://example.com/example.png"
    ],
    "resolution": "480p",
    "ratio": "9:16",
    "duration": 4,
    "watermark": true
  }'

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；必填：1；可选：7

promptstring必填

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

imagesstring[]

用作图片参考的公开可访问图片 URL 列表。

videosstring[]

用作视频参考的公开可访问视频 URL 列表。计算任务费用时会计入参考视频的时长。

audiosstring[]

用作音频参考的公开可访问音频 URL 列表。

resolutionstring

输出视频的分辨率。支持的值：480p、720p。

ratiostring

输出视频的宽高比。支持的值：16:9、4:3、1:1、3:4、9:16、21:9 和 adaptive。设置为 adaptive 时，模型会根据输入内容自动选择最合适的宽高比。

durationinteger

输出视频的时长，单位为秒。接受 4 至 15 的整数，也可以设置为 -1，由模型自动选择时长。

watermarkboolean

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

查询任务结果 - 输入参数

总计：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 助手中，帮助 AI 理解本模型的 API 接入方式、调用流程和关键参数。点击“复制 LLM 提示词”按钮或复制下方代码块中的完整内容。

# bytedance/seedance-2-0-economy

> Seedance 2.0 Economy 提供最高的画面质量。

## 概述

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

## API 信息

- **Base URL**：`https://api.icreat.ai`
- **任务提交接口（POST）**：`/v1/task/submit/bytedance/seedance-2-0-economy`
- **任务结果查询接口（POST）**：`/v1/task/result`
- **模型 ID**：`bytedance/seedance-2-0-economy`
- **认证方式**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

1. **提交任务**：向任务提交接口发送 POST 请求，并在请求体中传入生成参数。接口返回 `{ "task_id": "..." }`。
2. **查询结果**：向 `/v1/task/result` 发送 POST 请求，请求体为 `{ "task_id": "..." }`。响应包含 `status` 和 `result`。任务处理中，`result` 为 `[]`；当状态为 `SUCCEEDED` 时，`result` 包含生成资源数组，并且响应中包含 `costUSD`。从 `type` 为 `Video` 的资源中读取 `url` 或 `download_url`。

## 任务提交请求示例

```json
{
  "prompt": "示例多行\n文本",
  "images": [
    "https://example.com/example.png"
  ],
  "videos": [
    "https://example.com/example.png"
  ],
  "audios": [
    "https://example.com/example.png"
  ],
  "resolution": "480p",
  "ratio": "9:16",
  "duration": 4,
  "watermark": true
}
```

## 输入参数说明

- `prompt`（必填）：用于描述待生成视频的文本提示词，支持多行文本。
- `images`（可选）：用作图片参考的公开可访问图片 URL 列表。
- `videos`（可选）：用作视频参考的公开可访问视频 URL 列表。计算任务费用时会计入参考视频的时长。
- `audios`（可选）：用作音频参考的公开可访问音频 URL 列表。
- `resolution`（可选）：输出视频的分辨率。支持 `480p` 和 `720p`。
- `ratio`（可选）：输出视频的宽高比。支持 `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9` 和 `adaptive`。设置为 `adaptive` 时，模型会根据输入内容自动选择最合适的宽高比。
- `duration`（可选）：输出视频的时长，单位为秒。接受 `4` 至 `15` 的整数，也可以设置为 `-1`，由模型自动选择时长。
- `watermark`（可选）：是否在输出视频中添加“AI Generated”水印。

## 输出说明

- 轮询任务时需要检查 `status`。任务处理中，`result` 为 `[]`。
- 任务成功后，响应格式为 `result: [{ "type": "Video", "url": "...", "download_url": "..." }]`，并且包含 `costUSD`。

## 注意事项

- 提交任务和查询任务结果时必须使用同一个 `task_id`。
- 任务处理中，`result` 为 `[]`，需要继续轮询。
- `FAILED` 是终态。任务失败时，请检查请求参数和参考资源。