Skip to main content

​
Veo-3 视频生成示例

以下示例展示如何使用 Veo-3模型生成高质量的视频内容。Veo-3是Google最新的视频生成模型，支持高分辨率、长时长的视频生成。

​
快速开始

# 1. 提交视频生成任务
curl -X POST "https://model-api.skyengine.com.cn/v1beta/models/veo-3.0-generate-001:predictLongRunning" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "instances": [
      {
        "prompt": "一个年轻的渔夫在海边举着一条大鱼，阳光明媚，背景是蔚蓝的大海和晴朗的天空"
      }
    ],
    "parameters": {
      "aspectRatio": "16:9",
      "durationSeconds": 4,
      "enhancePrompt": true,
      "resolution": "1080p",
      "sampleCount": 1,
      "seed": 12345,
      "compressionQuality": "OPTIMIZED"
    }
  }'

# 2. 查询任务状态（使用返回的 name 字段作为 OPERATION_NAME）
curl -X GET "https://model-api.skyengine.com.cn/v1beta/{OPERATION_NAME}" \
  -H "Authorization: Bearer <API-KEY>"

​
支持的参数

  • aspectRatio: 视频宽高比（“16:9” 默认、“9:16”）
  • durationSeconds: 生成的视频的时长（“4”、“6”、“8”）。使用扩展或插值时必须为”8”（同时支持16:9和9:16），使用referenceImages时必须为”8”（仅支持16:9）
  • enhancePrompt: 是否增强提示词（建议设为true）
  • resolution: 视频分辨率（“720p” 默认、“1080p” 仅支持8秒时长）
  • seed: 随机种子（用于可重复生成）
  • generateAudio: 是否生成音频（true/false）
  • negativePrompt: 负向提示词，描述不希望在视频中出现的内容
  • personGeneration: 控制人物的生成。文生视频和扩展功能仅限”allow_all”，图生视频、插帧和参考图片仅限”allow_adult”

​
视频生成流程

  1. 提交任务: 发送predictLongRunning请求，获得操作名称
  2. 等待处理: 轮询操作状态直到完成
  3. 下载视频: 从响应中提取视频数据并保存

​
响应示例

​
任务提交响应

{
  "name": "projects/gcp-quwan-gemini/locations/us-central1/publishers/google/models/veo-3.0-generate-001/operations/2cd6428a-24c4-4a35-be15-65b62861c2ba"
}

​
状态查询响应（进行中）

{
  "name": "projects/gcp-quwan-gemini/locations/us-central1/publishers/google/models/veo-3.0-generate-001/operations/2cd6428a-24c4-4a35-be15-65b62861c2ba",
  "done": false
}

​
状态查询响应（完成）

{
  "done": true,
  "name": "projects/gcp-quwan-gemini/locations/us-central1/publishers/google/models/veo-3.0-generate-001/operations/2cd6428a-24c4-4a35-be15-65b62861c2ba",
  "response": {
    "generatedVideos": [
      {
        "video": {
          "mimeType": "video/mp4",
          "uri": "xxxxxx",
          "videoBytes": "<base64>"
        }
      }
    ]
  }
}