Veo 3.1 API

认识 Veo 3.1，这是 Google DeepMind 最新的视频生成模型，具备原生音频支持，专为电影制作人和故事讲述者设计。它提供了更真实的动作、更好的创意意图对齐以及更强的风格控制，包括电影感外观和改进的图生视频质量。在 EvoLink 上使用 Veo 3.1 构建，让短场景栩栩如生。

Model Type :

Veo 3.1 Fast Lite Veo 3.1 Pro Lite Veo 3.1 Fast Veo 3.1 Pro

Prompt

Estimated Cost

60 Credits

Sample Result

No sample available

Prompt

0 (suggested: 2,000)

Input Images

Upload up to 3 images

Click to upload or drag and drop

Supported formats: JPG, JPEG, PNG, WEBP
Maximum file size: 10MB; Maximum files: 3

Aspect Ratio

Only 16:9 is supported when using reference images or 3 images.

Quality

Click Generate to see preview

History

最多保留20条

0 运行中 · 0 已完成

您的生成历史将显示在这里

Veo 3.1 API - 面向短视频片段的 EvoLink 视频生成

使用 Veo 3.1 API 创建 4、6 或 8 秒的 MP4 视频，支持 720p、1080p 或 4K 分辨率，以及 16:9、9:16 或自动纵横比。Veo 3.1 API 任务异步运行并返回任务 ID；下载链接有效期为 24 小时，方便团队排队批处理并快速收集结果。

Pricing

Model	Mode	quality	Price
Veo 3.1 Fast Lite	Video Generation	720p / 1080p	Popular $0.1681/ video(12.1 Credits)
Veo 3.1 Fast Lite	Video Generation	4K	$0.5042/ video(36.3 Credits)

Popular

Veo 3.1 Fast Lite

Video Generation

quality:720p / 1080p

Price:

$0.1681/ video

(12.1 Credits)

Veo 3.1 Fast Lite

Video Generation

quality:4K

Price:

$0.5042/ video

(36.3 Credits)

If it's down, we automatically use the next cheapest available—ensuring 99.9% uptime at the best possible price.

利用 Veo 3.1 API 可以构建什么？

短视频增长内容

借助 Veo 3.1 API，增长团队可以在一个周期内生成多个广告或社交媒体变体。选择 4/6/8 秒时长、16:9 或 9:16 纵横比以及 720p/1080p/4K 画质。使用 veo3.1-fast 快速迭代钩子（Hooks）和格式，然后保留表现最佳的剪辑进行规模化推广。

开始使用 API

带帧控制的产品演示

Veo 3.1 API 支持使用 1 到 2 张图像进行首尾帧图生视频，非常适合产品演示、UI 转换和故事板。自动纵横比可以匹配您的源图像，enhance_prompt 可以将非英语提示词翻译成英语，以便全球团队获得更可靠的结果。

开始使用 API

参考图引导的视觉风格

对于风格探索，EvoLink 上的 Veo 3.1 API 在 Fast 端点提供 REFERENCE 模式，允许使用最多三张图像进行视觉引导。此模式仅限于 16:9，最适合受控的电影感外观。预览端点也支持固定 8 秒输出的 REFERENCE 模式，有助于对外观进行 A/B 测试。

开始使用 API

为什么开发者选择 Veo 3.1 API

EvoLink 上的 Veo 3.1 API 将可预测的格式（4/6/8秒、720p/1080p/4K、16:9/9:16/自动）与异步任务 ID 和 24 小时下载链接相结合，方便团队规划具有可靠周转时间的批量生成任务。

可预测的交付格式

固定的时长和分辨率选项简化了故事板、时间线和发布检查。

可扩展的异步流水线

任务 ID、状态查询和 callback_url 支持使大型队列保持稳定且可追溯。

实用模式带来的控制力

TEXT、FIRST&LAST 和 REFERENCE 模式加上图像限制，使控制更加明确且一致。

如何集成 Veo 3.1

一个简单的 API 流程，用于在 EvoLink 上通过 Veo 3.1 API 生成短视频并快速迭代。

第 1 步 - 选择模型设置

选择 veo3.1-pro 或 veo3.1-fast，然后为您的工作流设置时长、质量、纵横比和生成类型。

第 2 步 - 发送提示词与图像

提交最多 2000 个 Token 的提示词，根据需要添加图像 URL，启用 enhance_prompt，并包含 callback_url。

第 3 步 - 收集结果

轮询任务状态或接收回调，然后在 24 小时内下载 MP4 链接并安全存储。

打开 API Playground

核心能力

通过 EvoLink 上的 Veo 3.1 API 端点提供的实用功能

模型

EvoLink 上的模型选择

Veo 3.1 API 包括 veo3.1-pro 和 veo3.1-fast Lite 端点，以及提供 generate_audio 等更深层控制的预览模型。这让团队能够在不改变集成方式的情况下平衡速度、成本和控制。

模式

多种生成模式

使用 TEXT 进行纯提示词生成，使用 FIRST&LAST 桥接两帧，以及在 Fast 端点使用 REFERENCE 进行风格引导。REFERENCE 支持最多三张图像且仅限 16:9；预览版 REFERENCE 固定时长为 8 秒。

格式

质量与纵横比控制

将质量设置为 720p、1080p 或 4K，并选择 16:9、9:16 或自动纵横比。这使得 Veo 3.1 API 适用于信息流和故事（Story）位置，无需额外的编辑步骤。

工作流

异步任务与回调

请求返回用于状态检查的任务 ID。您可以传递 callback_url 用于完成、失败或取消事件；需要 HTTPS 且屏蔽内部 IP。生成的视频链接有效期为 24 小时，请及时下载。

提示词

提示词处理与翻译

提示词限制为 2000 个 Token。启用 enhance_prompt 后，非英语提示词会自动翻译成英语以获得更好的生成结果，这对于需要一致输出质量的全球团队非常有用。

音频

预览版音频与安全选项

预览端点支持 generate_audio（额外费用）以及 negative_prompt、person_generation 和图生视频的 resize_mode 等参数。这些选项帮助团队精细化输出控制，同时保持 Veo 3.1 API 集成的一致性。

常见问题解答

Everything you need to know about the product and billing.

Veo 3.1 是 EvoLink 的视频生成模型系列，提供 veo3.1-pro 和 veo3.1-fast 选项。它支持文生视频和首尾帧图生视频，异步运行，并返回具有可选纵横比和质量的短 MP4 片段（4/6/8 秒）。生成的视频链接在 24 小时内有效，方便团队快速下载并归档结果。

Veo 3.1 API 提供 veo3.1-pro 和 veo3.1-fast Lite 端点。当您需要在许多提示词或创意变体之间快速迭代时，请使用 veo3.1-fast；当您需要更精致的基准进行审查时，请使用 veo3.1-pro。EvoLink 还提供预览模型（如 veo-3.1-fast-generate-preview），增加了 generate_audio 等高级参数。最佳方法是在两者上测试相同的提示词并比较结果。

Veo 3.1 API 接受最多 2000 个 Token 的文本提示词和可选的图生视频 image_urls。对于 veo3.1-pro，您可以提供最多两张图像；对于 veo3.1-fast 和预览端点，您可以根据模式提供最多三张图像。图像必须是直接 URL，大小在 10MB 以内，格式为 .jpg、.jpeg、.png 或 .webp。您还可以设置 generation_type、aspect_ratio 和 enhance_prompt 以改进结果。

Veo 3.1 API 输出时长为 4、6 或 8 秒的 MP4 视频。您可以选择 720p、1080p 或 4K 质量，并在 Lite 端点上将 aspect_ratio 设置为 16:9、9:16 或自动。API 是异步的，下载链接在完成后 24 小时内有效。这种可预测的规格集有助于团队批量渲染广告、社交帖子和产品预览素材。

在 Veo 3.1 API 中，FIRST&LAST 模式允许您提供一到两张图像来引导片段的开始和结束，非常适合故事板和转场。在 Fast 端点上，REFERENCE 模式接受最多三张图像进行风格引导，且仅限 16:9。在预览端点上，REFERENCE 还会将时长固定为 8 秒，并限制高级参数（generate_audio 除外）。请选择最符合您控制需求的模式。

Veo 3.1 API 请求异步运行并返回任务 ID。您可以轮询任务状态端点，或提供 callback_url 以在计费确认后接收完成、失败或取消通知。回调必须使用 HTTPS，屏蔽内部 IP，且 EvoLink 会对失败的回调进行最多三次重试（10 秒超时）。这种设计对于基于队列的流水线和大型批处理任务非常可靠。

音频生成在预览端点（如 veo-3.1-fast-generate-preview）上可用。generate_audio 参数控制是否创建音频，并会产生额外费用。如果您需要为原型或演示生成音频，请在预览模型上启用 generate_audio，然后在移至生产环境前确认输出质量。对于 Lite 端点，请专注于视频生成，并在需要时在后期添加音频。

Veo 3.1 API 支持最多 2000 个 Token 的提示词，且默认启用 enhance_prompt 以自动将非英语提示词翻译成英语，从而获得更好的结果。为了获得最高的一致性，建议编写包含场景、摄像机和风格细节的清晰英语提示词。如果您本地化提示词，请保持结构一致，让 enhance_prompt 处理翻译，同时监控各地区的输出质量。

API Reference

Select endpoint

Authentication

All APIs require Bearer Token authentication.

Header

Authorization: 
Bearer YOUR_API_KEY

Get API Key

POST

/v1/videos/generations

Create Video

Veo 3.1 Fast Lite (veo3.1-fast) model supports text-to-video, first-frame image-to-video and other modes.

Asynchronous processing mode, use the returned task ID to .

Generated video links are valid for 24 hours, please save them promptly.

Request Parameters

modelstringRequiredDefault: veo3.1-fast

Video generation model name.

Exampleveo3.1-fast

promptstringRequired

Prompt describing what kind of video to generate.

Notes

Limited to 2000 tokens

ExampleA cat playing piano

aspect_ratiostringOptionalDefault: auto

Video aspect ratio. When set to auto: image-to-video will automatically select based on the input image ratio, text-to-video will automatically select based on the prompt content.

Value	Description
auto	Automatic selection based on input
16:9	Landscape video
9:16	Portrait video

Exampleauto

image_urlsarrayOptional

Reference image URL list for image-to-video feature.

Notes

1 image for first-frame video generation
2 images for first-and-last-frame video generation
Up to 3 images for reference image to video
Max size: 10MB per image
Formats: .jpg, .jpeg, .png, .webp
URLs must be directly viewable by the server

Examplehttp://example.com/image1.jpg

generation_typestringOptional

Video generation mode, default matches based on image count.

Value	Description
TEXT	Text to video
FIRST&LAST	First and last frame to video (1-2 images)
REFERENCE	Reference image to video (up to 3 images, 16:9 only)

ExampleTEXT

enhance_promptbooleanOptionalDefault: true

Whether to automatically translate the prompt to English. When enabled, non-English prompts will be automatically translated to English for better generation results.

Exampletrue

callback_urlstringOptional

HTTPS callback address after task completion.

Notes

Triggered on completion, failure, or cancellation
Sent after billing confirmation
HTTPS only, no internal IPs
Max length: 2048 chars
Timeout: 10s, Max 3 retries

Examplehttps://your-domain.com/webhooks/video-task-completed

qualitystringOptionalDefault: 720p

Video resolution quality.

Value	Description
720p	HD resolution
1080p	Full HD resolution
4k	Ultra HD resolution (4K)

Example720p

Request Example

{
  "model": "veo3.1-fast",
  "prompt": "A cat playing piano",
  "aspect_ratio": "16:9"
}

Response Example

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "veo3.1-fast",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 180,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 60,
    "user_group": "default"
  }
}