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，再轮询任务状态，最后在状态为 SUCCEEDED 时获取生成结果。以下示例使用同一 task_id 串联三个步骤。

1. 提交任务

向提交接口发送生成请求。成功后响应体返回 task_id，请保存该 ID 用于后续轮询与取结果。

POST/v1/task/submit/bytedance/seedance-2-5

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/bytedance/seedance-2-5 \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "content": [
    {
      "type": "text",
      "text": "Replace the cat in this video with the dog in the picture. Keep the original movement, camera behavior, timing, and scene."
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/video.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/dog.jpg"
      },
      "role": "reference_image"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 10,
  "watermark": false
}'

2. 轮询状态

使用提交步骤返回的 task_id 查询任务进度。响应体仅包含 status 字段（SUBMITTED | SUCCEEDED | FAILED）；为 SUCCEEDED 时可获取结果，为 FAILED 时表示任务失败。

POST/v1/task/query-status

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

3. 获取结果

任务成功后，使用同一 task_id 拉取最终输出。响应体为资源数组，每项包含 type、url 与 download_url；url 用于预览或在线访问，download_url 用于下载文件。

POST/v1/task/get-result

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

输入参数

提交任务 — 输入参数

以下参数在提交任务请求体中被接受。API 采用多模态输入结构；content 为必填数组，支持文本、图片、视频与音频参考的任意组合。

总计: 7 必填: 1 可选: 6

contentarray[object]必填

多模态内容数组。每一项表示一条文本提示词或一条参考媒体资源。

最少项1

generate_audioboolean

是否为输出视频生成音频。

ratiostring

输出宽高比。设为 adaptive 时，模型会根据输入自动选择最合适的宽高比。

16:94:31:13:49:1621:9adaptive

resolutionstring

输出分辨率。

480p720p

durationinteger

视频时长（秒）。可填 4–30 的整数，或 -1 由模型自动选择时长。

watermarkboolean

是否在输出视频上添加「AI Generated」水印。

toolsarray[object]

要使用的工具列表。

轮询状态 — 输入参数

总计: 1 必填: 1 可选: 0

task_idstring必填

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

获取结果 — 输入参数

总计: 1 必填: 1 可选: 0

task_idstring必填

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

输出参数

提交任务 — 输出参数

总计: 1

task_idstring

异步任务的唯一标识。使用此 ID 轮询状态并获取结果。

轮询状态 — 输出参数

总计: 1

statusstring

当前任务状态。当状态为 SUCCEEDED 时可获取结果。

SUBMITTEDSUCCEEDEDFAILED

获取结果 — 输出参数

响应体为资源对象数组（array[object]）。

总计: 3

typestring

资源类型，视频模型为 Video。

urlstring

生成视频的预览/访问 URL。

download_urlstring

生成视频的下载 URL（带 attachment 响应头）。

LLM友好的提示词

以下是一段 LLM 友好的 Markdown 提示词，可复制到 Cursor、ChatGPT 等 AI 助手中，帮助 AI 理解本模型的 API 接入方式、调用流程与关键参数。点击「复制LLM提示词」按钮或下方代码块均可复制全文。

# bytedance/seedance-2-5

> Seedance 2.5 是字节跳动的多模态视频生成模型，支持参考图片、视频与音频生成视频，单次最长 30 秒，支持视频编辑、延展与 `web_search` 工具。

## 概述

通过 iCreat 三段式异步任务 API 提交生成请求，轮询任务状态后在成功时获取视频资源 URL。

## API 信息

- **Base URL**：`https://api.icreat.ai`
- **Submit endpoint (POST)**：`/v1/task/submit/bytedance/seedance-2-5`
- **Poll endpoint (POST)**：`/v1/task/query-status`
- **Get result endpoint (POST)**：`/v1/task/get-result`
- **Model ID**：`bytedance/seedance-2-5`
- **认证**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

1. **Submit**：POST submit 路径，Body 见输入要点；响应 `{ "task_id": "..." }`
2. **Poll**：POST `/v1/task/query-status`，Body `{ "task_id": "..." }`；响应**仅** `{ "status": "SUBMITTED|SUCCEEDED|FAILED" }`
3. **Get result**：`status` 为 `SUCCEEDED` 时 POST `/v1/task/get-result`；响应为顶层数组，`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`
- 结果：顶层 `[{ "type": "Video", "url": "...", "download_url": "..." }]`

## 注意事项

- 三段式须用同一 `task_id` 串联；不可跳过轮询
- `FAILED` 为终态，需排查请求参数或参考内容