switch_heading
Seedance 2.5 API 文档
通过 API v3 生成 Seedance 2.5 和 Seedance 2.5 Flash 视频:文生视频、参考图片/视频/音频、首尾帧、视频编辑和 4K 输出。
API v3 是只服务 Seedance 2.5 的独立接口。现有的 /v1 和 /v2 集成完全不变;只有需要 Seedance 2.5 时才改用 /v3。
快速开始
| 1 | curl -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
| 1 | Authorization: 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 积分。
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 积分 |
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 接口
/v3/generate创建 Seedance 2.5 或 Seedance 2.5 Flash 任务。接口立即返回 task_id,通过轮询 /v3/status 或传 callback_url 获取结果。
请求体
提示词(必填,最多 5000 字符)。
seedance-2.5(默认)或 seedance-2.5-flash。 Defaults to seedance-2.5.
输出时长(秒):4 到 30 之间的整数。视频编辑传 -1,输出时长与输入视频一致。 Defaults to 5.
Seedance 2.5:480p、720p 或 4k。Seedance 2.5 Flash:480p 或 720p。不支持 1080p。 Defaults to 720p.
16:9、9:16、4:3、3:4 或 adaptive。视频编辑必须用 adaptive。 Defaults to 16:9.
最多 4 张参考图片 URL(http/https)。在提示词里说明每张图怎么用。
作为首帧的图片 URL。不能与 image_urls、reference_video_urls、reference_audio_urls 同时使用。
可选,作为尾帧的图片 URL。必须同时传 first_frame_url。
最多 3 个参考视频 URL,总时长不超过 30 秒。视频编辑时只传 1 个视频,时长 4 到 30 秒。
最多 3 个参考音频 URL,例如音乐或人声。
同时生成配乐和音效。 Defaults to true.
允许模型联网查找提示词中的主体信息。 Defaults to false.
可选,任务结束时回调的 Webhook(公网地址,不支持 localhost)。
可选:允许结果展示在公开作品墙。
文生视频
| 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 | } |
参考图片 + 音频
| 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)
| 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 | } |
视频编辑
| 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 输出
| 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 | } |
/v3/status按 task_id 轮询,直到 status 为 SUCCESS 或 FAILED。这里只返回通过 /v3/generate 创建的任务。
查询参数
POST /v3/generate 返回的 task_id(以 sd25 结尾)。
请求示例
| 1 | curl -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] 取第一个。需要长期保存请自行下载。
| 1 | const 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。每次成功调用都会计费。
错误码
| Status | 触发场景 |
|---|---|
| 400 错误请求 | 参数缺失或不合法,例如不支持的 model、resolution、aspect_ratio、duration 或媒体 URL。message 会说明具体是哪个参数。 |
| 401 未授权 | API Key 缺失或无效。 |
| 402 | 积分不足以创建此任务。 |
| 404 未找到 | 任务不存在,或不是通过 /v3/generate 创建的。 |
| 500 服务器内部错误 | 服务端错误,请稍后重试;失败任务会自动退款。 |