跳转到主要内容
POST
/
v1
/
video
/
generations
Gemini原生（视频）
curl --request POST \
  --url https://api.leapx-hub.com/v1/video/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "durationSeconds": 123,
  "aspectRatio": "<string>",
  "resolution": "<string>",
  "image": "<string>",
  "lastFrame": "<string>",
  "generateAudio": true,
  "sampleCount": 123
}
'

​
简介

Veo 是 Google Vertex AI 推出的多模态视频生成模型，支持文生视频（T2V）、首帧约束与首尾帧约束（仅 3.1 系列）生成连贯视频。通过 LeapX 统一视频接口调用：先 提交任务 获取 task_id，再 查询任务 轮询状态并获取结果。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer sk-xxxxxxxxxx

​
支持的模型

模型 ID说明
veo-3.0-fast-generate-001文生视频、首帧模式，快速版（默认含音频）
veo-3.1-fast-generate-preview文生视频、首帧/首尾帧模式，快速版
veo-3.0-generate-preview文生视频、首帧模式
veo-3.1-generate-preview文生视频、首帧/首尾帧模式

​
调用流程

  1. 提交任务：POST /v1/video/generations，传入 model、prompt 及 Veo 专用参数。
  2. 轮询状态：GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
  3. 获取结果：成功时响应中的 url 为视频数据（Veo 可能为 data:video/mp4;base64,... 或 OSS 链接）。

​
Veo 专用参数

​
prompt
string
必填
视频生成提示词，描述画面与动作。
​
durationSeconds
integer
默认值:"4"
视频时长（秒），支持：4、6、8。
​
aspectRatio
string
默认值:"16:9"
宽高比，仅支持：16:9、9:16。
​
resolution
string
默认值:"1080p"
分辨率：720p、1080p。
​
image
string
首帧参考图（URL 或 Base64），用于图生视频/首帧约束。
​
lastFrame
string
尾帧参考图（仅 veo-3.1 系列支持），与首帧配合实现首尾帧约束。
​
generateAudio
boolean
默认值:"false"
是否生成同步音频。快速版模型会忽略该参数并始终包含音频。
​
sampleCount
integer
默认值:"1"
每次生成的视频数量，范围 1-4。
更多参数（如 personGeneration、addWatermark、seed）见 提交视频任务。

​
请求示例

提交 Veo 任务（文生视频）： 
curl -X POST "https://api.leapx-hub.com/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "清晨阳光洒在赛博城市的高楼群，镜头慢慢推进",
    "durationSeconds": 6,
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "generateAudio": false
  }'
查询任务状态： 
curl -X GET "https://api.leapx-hub.com/v1/video/generations/{task_id}" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"
完整请求/响应说明与多模型对比请参见 提交视频任务 与 查询视频任务。