视频生成
使用 OpenAI Videos 兼容接口生成视频,支持 Seedance 系列模型。
视频生成是异步的,分三步:
POST /v1/videos提交任务,立即返回任务 ID;GET /v1/videos/{id}查询进度,直到状态变为completed;GET /v1/videos/{id}/content下载 MP4 文件。
视频模型只能通过视频接口调用。Chat Completions、Responses、Messages 这些对话接口不能生成视频,聊天类客户端(Cherry Studio、各类 Agent 工具等)里填视频模型也不会出视频。用对话接口调用视频模型会返回
400,提示改用POST /v1/videos。
提交任务
curl https://api.flyrouter.ai/v1/videos \
-H "Authorization: Bearer $FLYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"prompt": "一只橘猫在阳光下的草地上奔跑,镜头跟随",
"seconds": "5",
"resolution": "720p"
}'提交成功会立即返回任务:
{
"id": "task_ONjXxwTNHDSrXnuIYoMe9yFzLlOArglc",
"object": "video",
"model": "seedance-2.5",
"status": "queued",
"progress": 0,
"created_at": 1793779897
}查询进度
curl https://api.flyrouter.ai/v1/videos/task_ONjXxwTNHDSrXnuIYoMe9yFzLlOArglc \
-H "Authorization: Bearer $FLYROUTER_API_KEY"status 的取值:
| 状态 | 说明 |
|---|---|
queued | 排队中 |
in_progress | 生成中,progress 为进度百分比 |
completed | 已完成,可以下载 |
failed | 失败,原因在 error.message,费用自动退回 |
生成一般需要 1–5 分钟,时长越长、清晰度越高越慢,建议每 10 秒左右查询一次。
下载视频
curl https://api.flyrouter.ai/v1/videos/task_ONjXxwTNHDSrXnuIYoMe9yFzLlOArglc/content \
-H "Authorization: Bearer $FLYROUTER_API_KEY" \
-L -o video.mp4下载需要带 API Key。需要长期保存的视频请下载到自己的存储。
参数
| 参数 | 说明 |
|---|---|
model | 必填,视频模型 ID,见下表 |
prompt | 必填,视频描述 |
seconds | 时长(秒),整数,范围见下表,不填用默认值 |
resolution | 清晰度,可选值见下表,不填用默认值 |
size | seedance-2.5 的画面宽高比:16:9、4:3、1:1、3:4、9:16、21:9 或 adaptive,默认 adaptive;首帧和首尾帧任务只能用 adaptive |
image_urls | 参考图数组,用于图生视频。每项为公网图片链接或 Base64 Data URL(如 data:image/png;base64,...);不支持上传文件 |
image_with_roles | seedance-2.5 的带角色图片数组,可通过 first_frame 和 last_frame 指定首尾帧,见下方示例 |
audio_urls | seedance-2.5 参考音频数组,每项为公网音频链接;可以与 image_urls 一起使用,也可以单独使用 |
resolution 控制清晰度,size 控制宽高比。例如普通文生视频可同时传 "resolution": "720p" 和 "size": "16:9"。上表的比例适用于 seedance-2.5,其他模型的可选比例请以对应模型要求为准。
n 只能为 1,不支持参考视频。seedance-2.5 不支持 tools、draft 或自动时长 -1;请指定 4–30 秒的整数时长。
首帧和首尾帧
seedance-2.5 可通过 image_with_roles 指定首帧和尾帧,每个角色各传一张公网图片。首帧或首尾帧任务的 size 必须为 adaptive 或省略,不能指定 16:9 等具体比例,否则上游会拒绝请求。可以使用宽高比符合预期的图片,但自适应模式不保证输出精确比例。
curl https://api.flyrouter.ai/v1/videos \
-H "Authorization: Bearer $FLYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"prompt": "镜头从首帧场景平滑过渡到尾帧场景",
"seconds": "5",
"resolution": "720p",
"size": "adaptive",
"image_with_roles": [
{"url": "https://example.com/first.jpg", "role": "first_frame"},
{"url": "https://example.com/last.jpg", "role": "last_frame"}
]
}'只需要首帧时,可仅传 first_frame。不要与 audio_urls 一起使用首尾帧:上游会把首尾帧角色转为普通参考图,无法保持首尾帧语义。普通参考图请使用 image_urls,避免与首尾帧角色混用。
参考图片和音频
seedance-2.5 最多支持 30 张参考图片。参考音频支持 MP3 和 WAV,最多 10 段,每段 2–30 秒且不超过 15 MB,总时长不超过 30 秒。素材链接应能从公网访问。提示词中可以用 @图片1、@音频1 引用数组中的素材。
curl https://api.flyrouter.ai/v1/videos \
-H "Authorization: Bearer $FLYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"prompt": "让@图片1中的角色随@音频1的节奏跳舞",
"seconds": "5",
"resolution": "720p",
"image_urls": ["https://example.com/reference.jpg"],
"audio_urls": ["https://example.com/reference.mp3"]
}'请使用 image_urls 和 audio_urls,不要使用 reference_image_urls 或 reference_audio_urls。
支持的模型
| 模型 | 时长(秒) | 清晰度 |
|---|---|---|
seedance-2.5 | 4–30,默认 5 | 480p / 720p / 1080p,默认 720p |
seedance-2.0 | 5–15,默认 5 | 480p / 720p / 1080p / 4k,默认 720p |
seedance-2.0-fast | 5–15,默认 5 | 480p / 720p,默认 720p |
seedance-2.0-mini | 5–15,默认 5 | 480p / 720p,默认 720p |
seedance-1-5-pro | 4–12,默认 5 | 480p / 720p / 1080p,默认 720p |
seedance-1-0-pro-quality | 2–12,默认 5 | 480p / 720p / 1080p,默认 1080p |
seedance-1-0-pro-fast | 2–12,默认 5 | 480p / 720p / 1080p,默认 1080p |
计费
按生成时长计费,单价随清晰度变化,以 模型价格 页面为准(视频模型标价单位为 USD / 秒)。提交任务时按所选时长和清晰度扣费,生成失败会自动退回。
常见错误
| 状态码 | 原因 |
|---|---|
400 seconds must be between ... | 时长超出该模型的范围 |
400 模型不支持当前接口 | 用对话接口调用了视频模型,请改用 POST /v1/videos |
401 | API Key 无效,或下载视频时没带 API Key |
403 | 余额不足请先 充值;或 Key 所在分组不包含视频模型,请用默认分组的 Key |