Veo 视频生成 - you-token文档

Google Veo 视频生成接口（官方格式）。
端点说明：
创建视频: POST /v1/video/generations
查询状态: GET /v1/video/generations/{task_id}
支持的模型（根据官方文档）：
模型分辨率时长特殊功能
veo-3.1-generate-preview 720p, 1080p(仅8秒), 4k(仅8秒) 4/6/8秒图生视频、首尾帧插值、参考图片(最多3张)、视频延展
veo-3.1-fast-generate-preview 720p, 1080p(仅8秒), 4k(仅8秒) 4/6/8秒图生视频、首尾帧插值、参考图片(最多3张)、视频延展
veo-3.0-generate-001 720p, 1080p(仅8秒), 4k(仅8秒) 4/6/8秒图生视频、首尾帧插值
veo-3.0-fast-generate-001 720p, 1080p(仅8秒), 4k(仅8秒) 4/6/8秒图生视频、首尾帧插值
veo-2.0-generate-001 不支持设置 5/6/8秒图生视频、首尾帧插值
分辨率与时长约束：
720p：支持 4、6、8 秒时长
1080p：仅支持 8 秒时长
4k：仅支持 8 秒时长
视频延展(extension)时：仅支持 720p
功能说明：
1.
文生视频：仅需 prompt 即可生成视频
2.
图生视频：使用 image 参数提供起始帧图片（所有 Veo 模型支持）
3.
首尾帧插值：使用 image + lastFrame 参数指定首尾帧（所有 Veo 模型支持）
4.
参考图片引导（仅 Veo 3.1）：使用 referenceImages 参数提供最多 3 张参考图片
5.
视频延展（仅 Veo 3.1）：使用 video 参数提供要延展的视频
personGeneration 参数说明：
Veo 3.1 文生视频/扩展：仅支持 "allow_all"
Veo 3.1 图生视频/插帧/参考图片：仅支持 "allow_adult"
Veo 3.0 文生视频：仅支持 "allow_all"
Veo 3.0 图生视频：仅支持 "allow_adult"
Veo 2.0：文生视频支持全部，图生视频支持 "allow_adult" 和 "dont_allow"
注意事项：
使用参考图片、1080p、4k 分辨率时，时长必须为 8 秒
Veo 2.0 不支持 resolution 参数
视频延展仅支持 Veo 生成的视频，且输入视频不超过 141 秒
图片/视频大小限制：
单次请求总大小不超过 10MB（Base64 编码后）
使用多张参考图片时，所有图片 Base64 编码后的总大小不超过 10MB
建议使用压缩后的图片以避免超出限制

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
  "model": "veo-3",
  "prompt": "A realistic 1080p video of a hot air balloon floating over a green meadow at sunrise, gentle wind, colorful wildflowers in the foreground, 20 seconds long, cinematic lighting, no blurriness",
  "negative_prompt": "blurry, low resolution, watermark, text, logo, overexposed",
  "duration": 20,
  "resolution": "1080p",
  "fps": 30,
  "style": "cinematic",
  "aspect_ratio": "16:9",
  "guidance_scale": 9.0,
  "seed": 123456789,
  "response_format": "mp4",
  "n": 1,
  "response_type": "sync"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
  "id": "video-gen-7f2d9c4a8b1e0c3d",
  "object": "video.generation",
  "created": 1741234567,
  "model": "veo-3",
  "status": "completed",
  "data": [
    {
      "video_id": "vid-9a8b7c6d5e4f3b2a1",
      "url": "https://veo-api-resource.xxx.com/gen/vid-9a8b7c6d5e4f3b2a1.mp4?sig=e1f2d3c4b5a6&exp=1741320967",
      "expires_at": 1741320967,
      "format": "mp4",
      "resolution": "1080p",
      "duration_actual": 20.0,
      "fps": 30,
      "aspect_ratio": "16:9",
      "size_bytes": 125829120,
      "variation_index": 0,
      "metadata": {
        "prompt": "A realistic 1080p video of a hot air balloon floating over a green meadow at sunrise, gentle wind, colorful wildflowers in the foreground, 20 seconds long, cinematic lighting, no blurriness",
        "negative_prompt": "blurry, low resolution, watermark, text, logo, overexposed",
        "style": "cinematic",
        "seed": 123456789,
        "guidance_scale": 9.0,
        "generation_time_seconds": 38.5
      }
    }
  ],
  "usage": {
    "prompt_tokens": 156,
    "video_tokens": 30000,
    "total_tokens": 30156,
    "duration_billed_seconds": 20
  },
  "error": null
}