Google · 发布于 2025-09-01

Veo 3

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

TextImage

Veo 3 is Google’s powerful video generation model that creates realistic videos from text and image prompts with built-in synchronized audio. It delivers cinematic visuals, natural motion, and strong scene understanding, enabling high-quality video creation for creative workflows, storytelling, advertising, and professional content production.

google/veo3

官方示例

输入

提示词

一名超高速超级英雄，酷似闪电侠，深夜在茂密幽暗的森林中疾驰。他移动时，树木模糊成绿黑交织的残影。每跨出一步，身后都迸发着火光轨迹，将部分低矮灌木丛点燃，燃起闪烁的余烬。他在树木间灵活穿梭时，身后留下的炽热轨迹，在森林地面上逐渐以灼热的熔岩火勾勒出“VEO 3 FAST”的字样。镜头拉远，完整呈现这段文字。

输出

参数说明

由模型输入 Schema 解析

参数	类型	默认值	说明
`prompt`必填	string	—	提示词
`negative_prompt`	string	—	反向提示词
`aspect_ratio`	string	16:9	视频宽高比16:9 · 9:16
`duration_seconds`	integer	8	视频时长（秒）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
`storage_uri`	string	—	Google Cloud Storage 存储 URI

接入示例

提交生成任务后轮询结果——一把 key 调用全部模型。

获取 API Key 获取 API Key

# 提交任务
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",
  "aspect_ratio": "16:9",
  "duration_seconds": 8,
  "enhance_prompt": true,
  "generate_audio": true,
  "person_generation": "allow_adult",
  "prompt": "一名超高速超级英雄，酷似闪电侠，深夜在茂密幽暗的森林中疾驰。他移动时，树木模糊成绿黑交织的残影。每跨出一步，身后都迸发着火光轨迹，将部分低矮灌木丛点燃，燃起闪烁的余烬。\n\n他在树木间灵活穿梭时，身后留下的炽热轨迹，在森林地面上逐渐以灼热的熔岩火勾勒出“VEO 3 FAST”的字样。镜头拉远，完整呈现这段文字。",
  "resolution": "1080p",
  "sample_count": 1
}'

# 轮询结果（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"}

# 提交任务
resp = requests.post(f"{BASE}/tasks/generations", headers=headers, data='''{
  "model": "google/veo3",
  "aspect_ratio": "16:9",
  "duration_seconds": 8,
  "enhance_prompt": true,
  "generate_audio": true,
  "person_generation": "allow_adult",
  "prompt": "一名超高速超级英雄，酷似闪电侠，深夜在茂密幽暗的森林中疾驰。他移动时，树木模糊成绿黑交织的残影。每跨出一步，身后都迸发着火光轨迹，将部分低矮灌木丛点燃，燃起闪烁的余烬。\n\n他在树木间灵活穿梭时，身后留下的炽热轨迹，在森林地面上逐渐以灼热的熔岩火勾勒出“VEO 3 FAST”的字样。镜头拉远，完整呈现这段文字。",
  "resolution": "1080p",
  "sample_count": 1
}''')
request_id = resp.json()["data"]["request_id"]

# 轮询结果
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" };

// 提交任务
const payload = {
  "model": "google/veo3",
  "aspect_ratio": "16:9",
  "duration_seconds": 8,
  "enhance_prompt": true,
  "generate_audio": true,
  "person_generation": "allow_adult",
  "prompt": "一名超高速超级英雄，酷似闪电侠，深夜在茂密幽暗的森林中疾驰。他移动时，树木模糊成绿黑交织的残影。每跨出一步，身后都迸发着火光轨迹，将部分低矮灌木丛点燃，燃起闪烁的余烬。\n\n他在树木间灵活穿梭时，身后留下的炽热轨迹，在森林地面上逐渐以灼热的熔岩火勾勒出“VEO 3 FAST”的字样。镜头拉远，完整呈现这段文字。",
  "resolution": "1080p",
  "sample_count": 1
};
const resp = await fetch(BASE + "/tasks/generations", {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
});
const { data } = await resp.json();

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