Veo 3.1 API 文档

将 Google AI 视频生成功能集成到您的应用程序的完整指南。

快速开始指南

几分钟内开始使用 Veo 3.1 API。

1

获取 API 密钥

首先，您需要从控制面板获取 API 密钥。

2

发起首次请求

1curl -X POST "https://veo3api.com/generate" \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "prompt": "a dog running",
6 "model": "veo3-fast",
7 "watermark": "veo"
8 }'
3

检查生成状态

视频生成是异步的。使用 https://veo3api.com/feed 端点检查状态，或提供

cURL
1curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
2 -H "Authorization: Bearer YOUR_API_KEY"

API 参考

完整的 Veo 3.1 API 端点、参数和响应格式参考。

基础 URL

https://veo3api.com

端点不需要 /api 前缀，直接调用 https://veo3api.com/（例如：https://veo3api.com/generate）。

身份验证

所有 API 请求都需要在 Authorization 头中使用 Bearer token 进行身份验证。

Authorization: Bearer YOUR_API_KEY
POSThttps://veo3api.com/generate

从文本或图片提示生成视频

请求体

参数类型必需描述
promptstring*视频生成的文本提示
modelstring*选择 veo3（高质量，180 积分）或 veo3-fast（快速生成，25 积分）
aspect_ratiostring宽高比：16:9（默认，1080P 高清）、9:16（竖屏）或 Auto（匹配图片）
image_urlsstring[]用于图生视频的图片 URL 数组
watermarkstring自定义水印文本。设置为 null 表示无水印

示例请求

JSON
1{
2 "prompt": "a dog running",
3 "model": "veo3-fast",
4 "watermark": "veo"
5}

响应

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
6 }
7}

积分消耗

模型类型积分费用
veo3-fast25 credits$0.25
veo3180 credits$1.80
extend与原视频相同-
get-1080p免费$0.00

注意：仅当视频生成成功完成时才会扣除积分。失败的任务不消耗积分。

GEThttps://veo3api.com/feed

检查视频生成任务的状态

示例请求

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

响应

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "request": {
6 "prompt": "a dog running",
7 "model": "veo3-fast",
8 "watermark": "veo"
9 },
10 "response": [
11 "https://cdn.veo3api.com/video/example_watermarked.mp4"
12 ],
13 "status": "COMPLETED",
14 "created_at": "2025-10-29 12: 20: 46"
15 }
16}

💡 提示：生成的视频 URL 可以从 data.response 数组中获取。

POSThttps://veo3api.com/extend

使用新的提示词延长现有视频。延长的视频将从原始视频结束的地方继续。

请求体

参数类型必需描述
task_idstring*要延长的原始已完成视频的 task_id
promptstring*描述如何继续/延长视频的文本提示
seedsinteger随机种子（10000-99999），用于可重复生成。相同种子产生相似结果
watermarkstring自定义水印文本。设置为 null 表示无水印

示例请求

JSON
1{
2 "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
3 "prompt": "The dog continues running and jumps over a fence",
4 "watermark": "veo"
5}

响应

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
6 "original_task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
7 "credits_consumed": 25
8 }
9}

注意：只有已完成的视频任务才能被延长。已转换为 1080P 的视频无法延长。

GEThttps://veo3api.com/get-1080p免费

获取已完成视频任务的高清 1080P 版本。此端点免费，不消耗任何积分。

示例请求

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

响应

JSON Response 200 OK
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
6 "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
7 }
8}

💡 提示：此端点完全免费。您可以获取任何已完成视频的 1080P 版本，无需消耗积分。

HTTP 状态码

状态码描述
200请求成功
400错误请求 - 参数无效
401未授权 - API 密钥无效
429超出速率限制
500内部服务器错误