label llms.txt open_chatgpt

Seedance 2.5 API 文档

通过 API v3 生成 Seedance 2.5 和 Seedance 2.5 Flash 视频:文生视频、参考图片/视频/音频、首尾帧、视频编辑和 4K 输出。

API v3 · 2.5 / 2.5 Flash Base URL: https://seedanceapi.org/v3

API v3 是只服务 Seedance 2.5 的独立接口。现有的 /v1 和 /v2 集成完全不变;只有需要 Seedance 2.5 时才改用 /v3。

快速开始

bash
1curl -X POST 'https://seedanceapi.org/v3/generate' \
2 -H 'Authorization: Bearer YOUR_API_KEY' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "model": "seedance-2.5",
6 "prompt": "A cinematic aerial shot over a coastline at golden hour",
7 "aspect_ratio": "16:9",
8 "resolution": "720p",
9 "duration": 10
10 }'

认证

所有请求都需要在 Authorization 请求头中携带 Bearer token。

重要: 在控制台的 API Keys 页面获取 API Key。请只在服务端使用,不要放进浏览器代码。 → 获取 API Key

http
1Authorization: Bearer YOUR_API_KEY

生成模式

模式需要传的字段
文生视频prompt + aspect_ratio
参考生成(图片、视频、音频)prompt + image_urls / reference_video_urls / reference_audio_urls
首帧 / 尾帧prompt + first_frame_url (+ last_frame_url)
视频编辑prompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive"

价格(积分)

按视频秒数计费,费率取决于模型、分辨率以及是否传参考视频。创建任务时扣费,任务失败会自动退回。

需要充值积分? → 前往价格页充值. 1 美元 = 100 积分。

2.5

Seedance 2.5

画质最高,支持 480p、720p 和原生 4K。

分辨率输入费率示例
480p文本 / 图片 / 音频28 积分 / 秒输出 10 秒 = 280 积分
480p含参考视频17 积分 / 秒参考 5 秒 + 输出 10 秒 = 255 积分
720p文本 / 图片 / 音频63 积分 / 秒输出 10 秒 = 630 积分
720p含参考视频38 积分 / 秒参考 5 秒 + 输出 10 秒 = 570 积分
4k文本 / 图片 / 音频251 积分 / 秒输出 10 秒 = 2510 积分
4k含参考视频155 积分 / 秒参考 5 秒 + 输出 10 秒 = 2325 积分
Flash

Seedance 2.5 Flash

更快更便宜,支持 480p 和 720p。

分辨率输入费率示例
480p文本 / 图片 / 音频18.5 积分 / 秒输出 10 秒 = 185 积分
480p含参考视频11.5 积分 / 秒参考 5 秒 + 输出 10 秒 = 173 积分
720p文本 / 图片 / 音频41 积分 / 秒输出 10 秒 = 410 积分
720p含参考视频25.5 积分 / 秒参考 5 秒 + 输出 10 秒 = 383 积分

传 reference_video_urls 时,按较低的视频输入费率,对参考视频秒数 + 输出秒数计费。视频编辑(duration 为 -1)按输入视频时长的 2 倍计费。总额向上取整到整数积分。

API 接口

POST/v3/generate

创建 Seedance 2.5 或 Seedance 2.5 Flash 任务。接口立即返回 task_id,通过轮询 /v3/status 或传 callback_url 获取结果。

请求体

Body ParametersJSON
prompt:string

提示词(必填,最多 5000 字符)。

model:optional string

seedance-2.5(默认)或 seedance-2.5-flash。 Defaults to seedance-2.5.

duration:optional number

输出时长(秒):4 到 30 之间的整数。视频编辑传 -1,输出时长与输入视频一致。 Defaults to 5.

resolution:optional string

Seedance 2.5:480p、720p 或 4k。Seedance 2.5 Flash:480p 或 720p。不支持 1080p。 Defaults to 720p.

aspect_ratio:optional string

16:9、9:16、4:3、3:4 或 adaptive。视频编辑必须用 adaptive。 Defaults to 16:9.

image_urls:optional string[]

最多 4 张参考图片 URL(http/https)。在提示词里说明每张图怎么用。

first_frame_url:optional string

作为首帧的图片 URL。不能与 image_urls、reference_video_urls、reference_audio_urls 同时使用。

last_frame_url:optional string

可选,作为尾帧的图片 URL。必须同时传 first_frame_url。

reference_video_urls:optional string[]

最多 3 个参考视频 URL,总时长不超过 30 秒。视频编辑时只传 1 个视频,时长 4 到 30 秒。

reference_audio_urls:optional string[]

最多 3 个参考音频 URL,例如音乐或人声。

generate_audio:optional boolean

同时生成配乐和音效。 Defaults to true.

web_search:optional boolean

允许模型联网查找提示词中的主体信息。 Defaults to false.

callback_url:optional string

可选,任务结束时回调的 Webhook(公网地址,不支持 localhost)。

public:optional boolean

可选:允许结果展示在公开作品墙。

文生视频

json
1{
2 "model": "seedance-2.5",
3 "prompt": "A slow dolly shot through a neon-lit street in the rain",
4 "aspect_ratio": "16:9",
5 "resolution": "720p",
6 "duration": 10
7}

参考图片 + 音频

json
1{
2 "model": "seedance-2.5",
3 "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio",
4 "image_urls": ["https://example.com/character.jpg"],
5 "reference_audio_urls": ["https://example.com/beat.mp3"],
6 "aspect_ratio": "9:16",
7 "resolution": "720p",
8 "duration": 8
9}

首尾帧(Flash)

json
1{
2 "model": "seedance-2.5-flash",
3 "prompt": "The flower bud slowly opens into full bloom",
4 "first_frame_url": "https://example.com/bud.jpg",
5 "last_frame_url": "https://example.com/bloom.jpg",
6 "resolution": "480p",
7 "duration": 6
8}

视频编辑

json
1{
2 "model": "seedance-2.5",
3 "prompt": "Change the season to winter with falling snow; keep the camera motion",
4 "reference_video_urls": ["https://example.com/input-12s.mp4"],
5 "aspect_ratio": "adaptive",
6 "duration": -1,
7 "resolution": "720p"
8}

4K 输出

json
1{
2 "model": "seedance-2.5",
3 "prompt": "Macro shot of morning dew rolling off a green leaf",
4 "aspect_ratio": "16:9",
5 "resolution": "4k",
6 "duration": 5
7}

响应

Task created

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd25",
6 "status": "IN_PROGRESS",
7 "consumed_credits": 630
8 }
9}
GET/v3/status

按 task_id 轮询,直到 status 为 SUCCESS 或 FAILED。这里只返回通过 /v3/generate 创建的任务。

查询参数

Body ParametersJSON
task_id:string

POST /v3/generate 返回的 task_id(以 sd25 结尾)。

请求示例

bash
1curl -X GET 'https://seedanceapi.org/v3/status?task_id=n90a1b2c3d4e5f6sd25' \
2 -H 'Authorization: Bearer YOUR_API_KEY'

Tip: status 为 SUCCESS 时,data.response 是视频 URL 数组,用 data.response[0] 取第一个。需要长期保存请自行下载。

javascript
1const videoUrl = data.response[0];

响应

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd25",
6 "status": "SUCCESS",
7 "consumed_credits": 630,
8 "created_at": "2026-11-19T10:30:00Z",
9 "type": "seedance-2.5-t2v",
10 "request": {
11 "model": "seedance-2.5",
12 "prompt": "A slow dolly shot…",
13 "aspect_ratio": "16:9",
14 "duration": 10
15 },
16 "response": [
17 "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4"
18 ],
19 "error_message": null
20 }
21}

在线调试

在浏览器里直接调用接口。把 YOUR_API_KEY 换成你的真实 Key。每次成功调用都会计费。

API 测试沙盒POST

错误码

Status触发场景
400 错误请求参数缺失或不合法,例如不支持的 model、resolution、aspect_ratio、duration 或媒体 URL。message 会说明具体是哪个参数。
401 未授权API Key 缺失或无效。
402 积分不足以创建此任务。
404 未找到任务不存在,或不是通过 /v3/generate 创建的。
500 服务器内部错误服务端错误,请稍后重试;失败任务会自动退款。