Veo 3.1 API 文档

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

快速开始指南

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

获取 API 密钥

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

发起首次请求

curl -X POST "https://veo3api.com/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a dog running",
    "model": "veo4",
    "duration": 5,
    "resolution": "720p"
  }'

检查生成状态

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

cURL

curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
  -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

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

请求体

参数	类型	必需	描述
`prompt`	string	*	视频生成的文本提示
`model`	string	*	可选择 veo3（高质量，180 积分）、veo3-fast（快速生成，25 积分）或 veo4（按时长和分辨率计费，详见下表）
`duration`	integer		Veo 4 时长：5、10 或 15 秒（默认 5 秒）
`resolution`	string		Veo 4 输出分辨率：480p、720p（默认）或 1080p
`aspect_ratio`	string		宽高比：16:9（默认，1080P 高清）、9:16（竖屏）或 Auto（匹配图片）
`image_urls`	string[]		用于图生视频的图片 URL 数组
`watermark`	string		自定义水印文本。设置为 null 表示无水印

示例请求

JSON

{
  "prompt": "a dog running",
  "model": "veo4",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16: 9"
}

响应

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n90a1b2c3d4e5f6sd20",
    "status": "IN_PROGRESS",
    "consumed_credits": 240,
    "model": "veo4"
  }
}

积分消耗

模型类型	积分	费用
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`veo4`480p · 5s / 10s / 15s	160 / 320 / 480 credits	$1.60 / $3.20 / $4.80
`veo4`720p · 5s / 10s / 15s	240 / 480 / 720 credits	$2.40 / $4.80 / $7.20
`veo4`1080p · 5s / 10s / 15s	360 / 720 / 1080 credits	$3.60 / $7.20 / $10.80
`extend`	与原视频相同	-
`get-1080p`	免费	$0.00

Veo 4 按时长和分辨率计费；文生视频与图生视频采用相同费率。

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

GEThttps://veo3api.com/feed

检查视频生成任务的状态

示例请求

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

响应

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "request": {
      "prompt": "a dog running",
      "model": "veo4",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16: 9"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "consumed_credits": 240,
    "type": "text-to-video",
    "model": "veo4",
    "created_at": "2025-10-29 12: 20: 46"
  }
}

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

POSThttps://veo3api.com/extend

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

请求体

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

示例请求

JSON

{
  "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
  "prompt": "The dog continues running and jumps over a fence",
  "watermark": "veo"
}

响应

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
    "original_task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

注意：此端点仅支持已完成的 veo3 和 veo3-fast 任务，不支持 Veo 4 任务；已转换为 1080P 的视频也无法延长。

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

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

示例请求

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

响应

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 提示：此端点仅支持已完成的 veo3 和 veo3-fast 任务，免费且不消耗积分。Veo 4 可在创建任务时直接选择 1080p。

HTTP 状态码

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