YM2API 3号机 帮助中心
https://router.yy2img.ai/v1获取 Key
视频 / Veo 3.1

veo-3.1

Veo 3.1：文生视频、图生视频（首帧）、首尾帧。按条计费。

分组 #12「【视频】多模型 · 按秒 / 按条计费」 · Key 需属于该分组

文生视频图生视频（首帧）首尾帧按条计费无额外收费最多 2 张图：首帧 / 首尾帧
价格—
本站近期成功率—
平均耗时—

能力与限制

时长约 8 s，不影响价格
分辨率720p（1280x720）
首尾帧2 张图 = 首尾帧
画面比例16:9（横屏，默认） / 9:16（竖屏）
参考图0–2 张：1 张 = 首帧；2 张 = 首尾帧（与 veo-3.1-lite 同一规则，本模型未单独测试）；不支持多图参考，3 张及以上返回 400
额外收费无。参考图、参考视频、参考音频均不另收费
计费按条：每条固定价，与时长、尺寸无关，失败不扣费

Veo 3.1 系列对比 · 本站实测

项目veo-3.1-liteveo-3.1当前veo-3.1-fastveo-3.1-1080pveo-3.1-fast-1080p
价格 / 条0.570.570.570.660.66
清晰度720p · 1280×720720p · 1280×720720p · 1280×7201080p · 1920×10801080p · 1920×1080
时长7.9 秒（实测）约 8 秒7.9 秒（实测）约 8 秒约 8 秒
0 张图 · 文生视频✅ 已实测 · 81 秒◯ 支持 · 未单独实测◯ 支持 · 未单独实测◯ 支持 · 未单独实测◯ 支持 · 未单独实测
1 张图 · 首帧✅ 已实测 · 152 秒◯ 支持 · 未单独实测◯ 支持 · 未单独实测◯ 支持 · 未单独实测✖ 不支持 · 返回 400（已实测）
2 张图 · 首尾帧✅ 已实测 · 132 秒◯ 支持 · 未单独实测◯ 支持 · 未单独实测◯ 支持 · 未单独实测✖ 不支持 · 返回 400
3 张图 · 多图参考✖ 不支持 · 返回 400（已实测）✖ 不支持 · 返回 400（已实测）✅ 已实测 · 162 秒✖ 不支持 · 返回 400（已实测）✖ 不支持 · 返回 400
超出张数✅ 本地 400，不扣费（已实测）✅ 本地 400，不扣费（已实测）✅ 本地 400，不扣费（已实测）✅ 本地 400，不扣费（已实测）✅ 本地 400，不扣费（已实测）
声音文生 / 首帧有，首尾帧这条无—有（实测）——
计费核对✅ 0.57 / 条（已核对）—✅ 0.57 / 条（已核对）——

✅ 已实测◯ 支持，未单独实测（规则同上）✖ 不支持实测日期 2026-11-05；耗时为从创建到完成。完整实测说明与示例视频见 Veo 3.1 总览。

请求参数

OpenAI Videos 格式，JSON 或 multipart 均可；官方 SDK 的 client.videos.create 可直接使用。

字段类型说明
modelstring必填固定为 veo-3.1
promptstring必填画面描述，不能为空
sizestring可选横屏 1280x720（默认）/ 竖屏 720x1280；只决定横竖屏，清晰度由模型决定
secondsstring可选仅记录；时长由模型决定，不影响价格
input_referencestring / file可选参考图：HTTPS 直链，或 multipart 上传文件
imagesarray可选更多图片 URL 数组，与 input_reference 合计最多 2 张；按顺序：第 1 张 = 首帧，第 2 张 = 尾帧

查询与下载

  1. POST /v1/videos 创建任务，拿到 id。
  2. 每 5–10 秒 GET /v1/videos/{id}；status 依次为 queued / in_progress / completed / failed。progress 是上游给的真实进度，部分线路不提供（一直是 0，完成时变 100）；未完成时若有 typical_seconds，表示本站该模型近 7 天的通常耗时（秒），仅供参考，不是这一单的预测。
  3. completed 后 GET /v1/videos/{id}/content 下载 mp4，用同一个 Key。
  4. 超时不要重复创建，保留任务 id 继续查询。

注意事项

  • 按条计费：每条固定价，与时长、尺寸无关。参考图、参考视频、参考音频均不另收费；不支持的素材直接报错，不扣费。
  • 接口：创建 POST /v1/videos（JSON 或 multipart；JSON 也可发到 /v1/videos/generations）；查询 GET /v1/videos/{id}；下载 GET /v1/videos/{id}/content。
  • 参考图须为公网 HTTPS 直链，或用 multipart 上传文件。
  • 完成后请尽快通过 /content 下载，链接有时效。

常见错误

返回原因与处理
400时长、分辨率或尺寸超出本模型范围，按上表检查
429 / 503线路繁忙，稍后重试；不要重复创建同一任务
status: failed查看返回的 error；多为内容审核或素材不可访问，失败的任务不扣费