Seedance 2.5 Flash 视频生成 API
使用文字、图片、视频或音频参考异步生成视频。公开模型 ID 固定为 `seedance-2.5-flash`,具有独立的价格和参数限制。
Seedance 2.5 Flash 视频生成 API
使用文字、图片、视频或音频参考异步生成视频。公开模型 ID 固定为 seedance-2.5-flash,具有独立的价格和参数限制。
能力与限制
输出支持 480p / 720p,时长为 4–30 秒整数,默认 5 秒;duration: -1 表示自动时长。不支持 1080p、4K 和 Draft 样片模式。
每次最多 10 张图片、5 段视频、5 段音频。参考视频或音频单段 2–30 秒,视频总时长和音频总时长分别不超过 30 秒。单张图片不超过 30 MB、单段视频不超过 200 MB、单段音频不超过 15 MB。使用有权使用且可以访问的素材。
参数
| 参数 | 类型 | 值 / 限制 |
|---|---|---|
model |
string | seedance-2.5-flash |
prompt |
string | Text |
resolution |
string | 480p / 720p; default 720p |
duration |
integer | 4–30, -1; default 5 |
seconds |
integer / string | Alias: duration |
aspect_ratio |
string | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive; default adaptive |
ratio |
string | Alias: aspect_ratio |
size |
string | Alias: resolution / pixel size; no conflicting resolution or ratio |
generate_audio |
boolean | default true |
audio |
boolean | Alias: generate_audio |
watermark |
boolean | default false |
return_last_frame |
boolean | default false |
seed |
integer | 0 is preserved |
output_format |
string | mp4 / mov; default mp4 |
omni_reference_task_type |
string | auto, reference, edit, extend |
image_urls |
string[] | 10 |
image_with_roles |
object[] | url, role: first_frame, last_frame, reference_image; images total ≤10 |
video_urls |
string[] | 5 |
audio_urls |
string[] | 5 |
content |
object[] | Native text, image_url, video_url, audio_url references |
metadata |
object | Optional wrapper for generation fields |
draft |
boolean | true: unsupported |
draft_task_id |
string | unsupported |
首尾帧、编辑和延长任务请保持 adaptive,输出跟随参考素材比例。编辑任务要求源视频为 4–30 秒,并设置 duration: -1。允许单独使用音频参考;MOV 等高级选项取决于所选生成路由的支持情况。
提交与下载
提交后保存返回的公开任务 ID,轮询到完成再下载。HTTP 200 只表示受理,不代表已生成。失败时先读取错误再提交新任务;只有重试完全相同的请求时才复用 Idempotency-Key。
curl "https://apimaster.ai/v1/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: flash-text-unique-001" \
-d '{"model":"seedance-2.5-flash","prompt":"A red paper boat floating on calm water at sunrise","duration":4,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true,"watermark":false}'
curl "https://apimaster.ai/v1/v1/videos/TASK_ID" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/v1/videos/TASK_ID/content" -H "Authorization: Bearer YOUR_API_KEY" -o video.mp4
curl "https://apimaster.ai/v1/v1/videos/TASK_ID/billing" -H "Authorization: Bearer YOUR_API_KEY"
参考素材、编辑与延长
{
"model": "seedance-2.5-flash",
"prompt": "The paper boat passes under a wooden bridge",
"duration": 4,
"resolution": "480p",
"aspect_ratio": "adaptive",
"generate_audio": false,
"image_with_roles": [
{
"url": "https://example.com/authorized-first-frame.png",
"role": "first_frame"
}
]
}
{
"model": "seedance-2.5-flash",
"prompt": "Change the lighting to warm sunset",
"resolution": "720p",
"duration": -1,
"aspect_ratio": "adaptive",
"omni_reference_task_type": "edit",
"video_urls": [
"https://example.com/authorized-source.mp4"
]
}
omni_reference_task_type: "extend" + duration: 4 + aspect_ratio: "adaptive".
计费
下表基础价格以国际版官方 Token 单价为参考。客户实际扣费还会应用当前渠道、分组及账户设置,请以模型卡和任务账单回执为准。仅含图片时按输出秒数计费;含视频参考时按实测输入秒数加输出秒数计费。官方 Token 账单可能有最低用量限制,因此上游实际费用与平台按秒估算可能有差异。
| 分辨率 | 美元 / 秒 | 美元 / 秒,含视频输入 |
|---|---|---|
| 480p | 0.0672525 | 0.04131225 |
| 720p | 0.1512 | 0.09288 |
排错
使用公开模型 ID,检查分辨率和素材数量,明确传入 false 等 JSON 布尔值。缺少指纹检测基线不等于视频生成失败。生成后及时下载,不要依赖临时视频链接长期保存。
