视频生成

视频是异步任务：提交拿到任务 ID，轮询到完成后再下载。通用视频模型（omni、veo-3.1、minimax-h3）走这一页；SD 系列见 SD 2.0 / 2.5 视频。

创建任务

curl -sS -X POST "$BASE_URL/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "prompt": "雨后的城市街道，镜头缓慢向前推进，电影感",
    "duration": 4,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "id": "task_01J00000000000000000000",
  "object": "video",
  "model": "veo-3.1",
  "status": "queued"
}

id 是本站任务 ID，后面查询和下载都用它。创建成功只代表任务入队，不代表视频已经生成。

查询与下载

# 轮询状态
curl -sS "$BASE_URL/videos/{task_id}" -H "Authorization: Bearer $API_KEY"

# 完成后取视频
curl -sS "$BASE_URL/videos/{task_id}/content" -H "Authorization: Bearer $API_KEY" -o out.mp4

状态流转：

queued → in_progress → completed

终态也可能是 failed 或 cancelled。只有 completed 才能请求 /content；失败终态不需要继续轮询。

{
  "id": "task_01J00000000000000000000",
  "object": "video",
  "model": "veo-3.1",
  "status": "failed",
  "error": {"code": "generation_failed", "message": "视频生成失败"}
}

通用参数

参数	必填	说明
model	是	omni、veo-3.1、minimax-h3
prompt	是	画面与镜头描述
duration	否	时长（秒），可选值由模型决定
aspect_ratio	否	16:9、9:16 等；也可用 size 表达比例
resolution	否	分辨率档位，omni / veo-3.1 当前为 720p
image / images	否	参考图；单值或字符串数组
video / videos	否	参考视频；单值或字符串数组
mode	否	t2v、i2v、r2v、interpolation、extend
seed	否	随机种子

不传 mode 时，服务会根据是否给出图片或视频自动判断。参考素材用公网可访问的 HTTPS 地址或 data: URL；不要把令牌写进素材地址的查询参数。

时长、比例、分辨率都通过请求字段传入，不要拼进模型名。不支持的组合返回 400 并指出要改的字段。

MiniMax H3

minimax-h3 当前只有 768p 一档，按条计费，与时长无关。参数范围独立于 omni / veo-3.1：

• 至少需要 1 张参考图，不支持纯文生视频，图片放进 images 数组。
• 支持 5～15 秒整数时长与 16:9 / 9:16 比例。
• 768p 是档位名称，不承诺成片精确为 768 像素；实际尺寸、帧率、时长以返回文件为准。

curl -sS -X POST "$BASE_URL/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "海浪拍打礁石，慢镜头",
    "images": ["https://example.com/ref.jpg"],
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "768p"
  }'

模型

模型	接口	分组
veo-3.1	Videos	视频分组低价1.5x
omni	Videos	视频分组低价1.5x
minimax-h3	Videos	视频分组低价1.5x
sd2.0	Videos	Seedance低价1x
sd2.5	Videos	Seedance低价1x

SD 系列的分辨率、时长与素材规则见 SD 2.0 / 2.5 视频。

注意

• 拿到任务 ID 之后就只查询这个 ID，不要重复提交同一条 prompt。
• 参考素材任务可能因素材处理或审核失败而终态失败，失败时预扣费用会自动退回。
• 对时长有硬性要求时，检查下载到的实际文件；接口返回的 duration 不一定等于成片真实时长。