Skip to main content
推荐使用 OpenAI 兼容接口，更简洁易用。原生接口适用于需要特定参数的场景。

​
创建视频任务

curl -X POST "$BASE_URL/v1beta/models/veo-3.1-generate-preview:predictLongRunning" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "instances": [{
      "prompt": "a drone rises from a beach at sunset, cinematic"
    }],
    "parameters": {
      "durationSeconds": 6,
      "aspectRatio": "16:9",
      "resolution": "720p"
    }
  }'
响应： 
{
  "name": "operations/abc123xyz",
  "done": false
}

​
图生视频

​
单图

{
  "instances": [{
    "prompt": "night city with neon rain",
    "image": {"uri": "https://example.com/ref.jpg"}
  }],
  "parameters": {
    "durationSeconds": 6,
    "aspectRatio": "16:9"
  }
}

​
首尾帧

{
  "instances": [{
    "prompt": "transition effect",
    "image": {"uri": "https://example.com/first.jpg"}
  }],
  "parameters": {
    "durationSeconds": 6,
    "lastFrame": {"uri": "https://example.com/last.jpg"}
  }
}

​
查询任务

curl "$BASE_URL/v1beta/operations/{operation_id}" \
  -H "Authorization: Bearer $TOKEN"
完成后响应： 
{
  "name": "operations/abc123xyz",
  "done": true,
  "response": {
    "generateVideoResponse": {
      "generatedSamples": [{
        "video": {"uri": "https://.../video.mp4"}
      }]
    }
  }
}

​
参数说明

参数说明
instances[].prompt文本提示词
instances[].image.uri首帧图片 URL
parameters.durationSeconds时长（秒）
parameters.aspectRatio宽高比：16:9、9:16
parameters.resolution分辨率：720p、1080p
parameters.lastFrame.uri尾帧图片 URL