视频生成

使用 OpenAI Videos 兼容接口生成视频,支持 Seedance 系列模型。

视频生成是异步的,分三步:

  1. POST /v1/videos 提交任务,立即返回任务 ID;
  2. GET /v1/videos/{id} 查询进度,直到状态变为 completed;
  3. 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"
  }'

提交成功会立即返回任务:

json
{
  "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清晰度,可选值见下表,不填用默认值
sizeseedance-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_rolesseedance-2.5 的带角色图片数组,可通过 first_frame 和 last_frame 指定首尾帧,见下方示例
audio_urlsseedance-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.54–30,默认 5480p / 720p / 1080p,默认 720p
seedance-2.05–15,默认 5480p / 720p / 1080p / 4k,默认 720p
seedance-2.0-fast5–15,默认 5480p / 720p,默认 720p
seedance-2.0-mini5–15,默认 5480p / 720p,默认 720p
seedance-1-5-pro4–12,默认 5480p / 720p / 1080p,默认 720p
seedance-1-0-pro-quality2–12,默认 5480p / 720p / 1080p,默认 1080p
seedance-1-0-pro-fast2–12,默认 5480p / 720p / 1080p,默认 1080p

计费

按生成时长计费,单价随清晰度变化,以 模型价格 页面为准(视频模型标价单位为 USD / 秒)。提交任务时按所选时长和清晰度扣费,生成失败会自动退回。

常见错误

状态码原因
400 seconds must be between ...时长超出该模型的范围
400 模型不支持当前接口用对话接口调用了视频模型,请改用 POST /v1/videos
401API Key 无效,或下载视频时没带 API Key
403余额不足请先 充值;或 Key 所在分组不包含视频模型,请用默认分组的 Key