众扬汇 AI 开放平台 API 文档

Veo图生视频

OpenAPI Specification

Veo 系列图生视频:按统一格式提交参考图与提示词。参考图数量随模型而异——veo2-fast-frames 最多两张(首帧与尾帧),veo3-pro-frames 最多一张(首帧),veo2-fast-components 最多 3 张(此时图片作为视频元素)。不传 aspect_ratio 时按参考图自动匹配比例,无法判断则输出横屏。

请求方式:POST

接口地址

text
https://api.allyang.cn/v2/videos/generations

请求头

  • Content-Type(必填):请求体类型,按本页标注填写。(示例:application/json)
  • Authorization(可选):鉴权头,使用控制台创建的令牌,格式为 Bearer + 令牌。(示例:Bearer {{YOUR_API_KEY}})

请求参数(application/json)

  • prompt(string,必填)
  • model(string,必填)
    • 可选值:veo3-pro-frames、veo3-fast-frames、veo2-fast-frames、veo2-fast-components、veo3.1、veo3.1-pro、veo3.1-components。
    • veo3-pro-frames:支持图生视频。
    • veo3.1:支持首尾帧;快速模式,自带音频生成,速度快、成本低,自适应首帧与文生视频。
    • veo3.1-pro:支持首尾帧;高质量模式,自带音频生成,画质更高、成本也更高,自适应首帧与文生视频。
    • veo3.1-components:支持 1~3 张参考图。
  • enhance_prompt(boolean,可选):是否自动优化提示词,缺省 false;因该模型仅接受英文提示词,需要中文自动转英文时可开启。
  • images(array,必填):图片地址,支持 URL 或 base64;veo2-fast-frames 最多两张(首帧与尾帧),veo3-pro-frames 最多一张(首帧),veo2-fast-components 最多 3 张(此时图片作为视频元素)。
  • aspect_ratio(string,可选)
    • 可选值:9:16、16:9。

请求示例

json
{
  "images": []
}

返回:HTTP 200 表示成功,响应体字段待补(以实测为准)。

使用提示:请先确认所用模型支持的参考图数量,超出会被拒绝;提交后请用查询接口轮询结果;耗时、限流与计费数值以本平台实测与计费页为准(待补)。