Google · Released 2025-10-16

Veo 3.1

Name: Veo 3.1
Brand: Google
Price: 0.20 USD
Availability: InStock

TextImage

Veo 3.1 is Google’s state-of-the-art video generation model, delivering production-quality video with high visual fidelity and synchronized audio. It creates 1080p videos from text or image prompts with support for dialogue, ambient effects, and background sound. With features including long-scene extension, frame-to-video transitions, vertical video generation, and 4K upscaling, Veo 3.1 enables advanced video creation for storytelling, marketing, and professional creative workflows.

google/veo3.1-preview

Official example

Input

Prompt

这位女士正在接受播客采访，穿着带有标志的蓝紫色上衣，上面写着胜算云的logo，她身处一个中世纪现代风格的工作室，配有白色灯光，她讲述了使用胜算云并搭配参考图片来制作视频的内容，标志也出现在她身后的黑色背景下有框照片

Output

Parameters

Derived from the model input schema

Parameter	Type	Default	Description
`prompt`Required	string	—	提示词
`negative_prompt`	string	—	反向提示词
`aspect_ratio`	string	16:9	视频宽高比16:9 · 9:16
`duration_seconds`	integer	8	视频时长（秒）4 · 6 · 8
`resolution`	string	720p	分辨率720p · 1080p
`generate_audio`	boolean	—	是否生成音频
`enhance_prompt`	boolean	true	是否使用Gemini优化提示词
`person_generation`	string	allow_adult	人物生成控制allow_adult · dont_allow
`sample_count`	integer	1	采样数量1 · 2 · 3 · 4
`seed`	integer	-1	随机种子-1 – 4294967295
`image`	string	—	输入图片Google Cloud Storage URI
`reference_images`	array	—	最多3张素材图片或1张风格图片≤ 3
`storage_uri`	string	—	Google Cloud Storage 存储 URI
`last_frame`Required	string	—	结束帧图片URL或GCS URI

API example

Submit a generation task, then poll for the result — one API key for every model.

Get API Key Get API Key

# Submit task
curl https://router-integration.test.cogfoundry.ai/api/v1/tasks/generations \
  -H "Authorization: Bearer $MODEL_CENTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/veo3.1-preview",
  "aspect_ratio": "16:9",
  "duration_seconds": 8,
  "enhance_prompt": true,
  "generate_audio": true,
  "person_generation": "allow_adult",
  "prompt": "这位女士正在接受播客采访，穿着带有标志的蓝紫色上衣，上面写着胜算云的logo，她身处一个中世纪现代风格的工作室，配有白色灯光，她讲述了使用 胜算云并搭配参考图片来制作视频的内容，标志也出现在她身后的黑色背景下有框照片\n",
  "reference_images": [
    {
      "image": "https://oss.shengsuanyun.com/example/modelinfo/201/2025-11-25_13:48:44_input_1.png",
      "reference_type": "ASSET"
    },
    {
      "image": "https://oss.shengsuanyun.com/example/modelinfo/201/2025-11-25_13:48:44_input_2.png",
      "reference_type": "ASSET"
    }
  ],
  "resolution": "720p",
  "sample_count": 1,
  "seed": -1
}'

# Poll result（REQUEST_ID 来自上一步返回的 data.request_id）
curl https://router-integration.test.cogfoundry.ai/api/v1/tasks/generations/REQUEST_ID \
  -H "Authorization: Bearer $MODEL_CENTER_API_KEY"

import requests

BASE = "https://router-integration.test.cogfoundry.ai/api/v1"
KEY = "$MODEL_CENTER_API_KEY"
headers = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

# Submit task
resp = requests.post(f"{BASE}/tasks/generations", headers=headers, data='''{
  "model": "google/veo3.1-preview",
  "aspect_ratio": "16:9",
  "duration_seconds": 8,
  "enhance_prompt": true,
  "generate_audio": true,
  "person_generation": "allow_adult",
  "prompt": "这位女士正在接受播客采访，穿着带有标志的蓝紫色上衣，上面写着胜算云的logo，她身处一个中世纪现代风格的工作室，配有白色灯光，她讲述了使用 胜算云并搭配参考图片来制作视频的内容，标志也出现在她身后的黑色背景下有框照片\n",
  "reference_images": [
    {
      "image": "https://oss.shengsuanyun.com/example/modelinfo/201/2025-11-25_13:48:44_input_1.png",
      "reference_type": "ASSET"
    },
    {
      "image": "https://oss.shengsuanyun.com/example/modelinfo/201/2025-11-25_13:48:44_input_2.png",
      "reference_type": "ASSET"
    }
  ],
  "resolution": "720p",
  "sample_count": 1,
  "seed": -1
}''')
request_id = resp.json()["data"]["request_id"]

# Poll result
result = requests.get(f"{BASE}/tasks/generations/{request_id}", headers=headers)
print(result.json())

const BASE = "https://router-integration.test.cogfoundry.ai/api/v1";
const KEY = "$MODEL_CENTER_API_KEY";
const headers = { Authorization: "Bearer " + KEY, "Content-Type": "application/json" };

// Submit task
const payload = {
  "model": "google/veo3.1-preview",
  "aspect_ratio": "16:9",
  "duration_seconds": 8,
  "enhance_prompt": true,
  "generate_audio": true,
  "person_generation": "allow_adult",
  "prompt": "这位女士正在接受播客采访，穿着带有标志的蓝紫色上衣，上面写着胜算云的logo，她身处一个中世纪现代风格的工作室，配有白色灯光，她讲述了使用 胜算云并搭配参考图片来制作视频的内容，标志也出现在她身后的黑色背景下有框照片\n",
  "reference_images": [
    {
      "image": "https://oss.shengsuanyun.com/example/modelinfo/201/2025-11-25_13:48:44_input_1.png",
      "reference_type": "ASSET"
    },
    {
      "image": "https://oss.shengsuanyun.com/example/modelinfo/201/2025-11-25_13:48:44_input_2.png",
      "reference_type": "ASSET"
    }
  ],
  "resolution": "720p",
  "sample_count": 1,
  "seed": -1
};
const resp = await fetch(BASE + "/tasks/generations", {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
});
const { data } = await resp.json();

// Poll result
const result = await fetch(BASE + "/tasks/generations/" + data.request_id, { headers });
console.log(await result.json());