Skip to main content
通过 即刻API 直连 Google Vertex AI Veo 3 官方端点，支持文生视频、图生视频（首帧/首尾帧插值）、参考图模式及音频生成，分辨率最高支持 4K，所有任务均为异步处理。
重要变更：为了更好的性能和成本控制，我们不再支持在 image_urls 中直接传入 base64 图片数据。请先使用上传图片接口上传图片，获取 URL 后再调用本接口。
生成的视频链接有效期为 24 小时，请及时保存。

​
请求参数

​
model
string
default:"Veo3.1-quality-official"
required
视频生成模型名称。可用模型：
  • Veo3.1-quality-official — 高质量生成模型，适用于最终制作（默认）
  • Veo3.1-fast-official — 快速生成模型，适用于快速预览和迭代
示例："Veo3.1-quality-official"
​
prompt
string
required
视频生成的文本描述。
​
duration
integer
default:"8"
视频时长（秒）。支持的值：
  • 4 — 4 秒
  • 6 — 6 秒
  • 8 — 8 秒（默认）
​
size
string
default:"16:9"
视频宽高比。支持的格式：
  • 16:9 — 横屏（默认）
  • 9:16 — 竖屏
​
resolution
string
default:"720p"
视频分辨率。支持的值：
  • 720p — 默认
  • 1080p
  • 4k（预览）
​
image_urls
string[]
图生视频的首帧参考图，视频将从该图像开始生成。仅使用数组中的第一个 URL。⚠️ 仅支持 URL 格式（不再支持 base64）
  • 公开可访问的图像 URL（http:// 或 https://）
  • 可使用上传图片接口上传本地图片获取 URL
限制：
  • 最大文件大小：10MB
  • 支持格式：.jpeg、.jpg、.png、.webp
image_urls 与 metadata.referenceImages 不可同时使用。如果同时传入，image_urls（首帧）优先，referenceImages 将被忽略。
​
metadata.generateAudio
boolean
default:"false"
是否生成音频。默认：false。启用后视频将包含 AI 生成的音效和环境音。
​
metadata.negativePrompt
string
负面提示词，描述不希望在视频中出现的内容。示例："模糊, 低质量, 畸变"
​
metadata.personGeneration
string
人物生成安全设置。支持的值：
  • allow_adult — 允许生成成年人
  • dont_allow — 不允许生成人物
​
metadata.lastFrame
string
尾帧图片 URL，用于首尾帧插值生成视频。必须与 image_urls（首帧）配合使用，生成从首帧到尾帧的过渡视频。单独使用无效。
​
metadata.referenceImages
string[]
素材/风格参考图 URL 数组，视频内容将参考这些图片的视觉风格和元素进行生成（不作为视频起始帧）。限制： 最多 3 张⚠️ 不可与 image_urls 同时使用——二者在 Veo API 中互斥。如需首帧控制，请使用 image_urls。
​
metadata.compressionQuality
string
default:"optimized"
视频压缩质量。支持的值：
  • optimized — 优化压缩（默认）
  • lossless — 无损压缩
​
metadata.resizeMode
string
图生视频时的图片调整模式。支持的值：
  • pad — 填充模式，保持原始比例
  • crop — 裁剪模式，填满画面

​
请求示例

curl --request POST \
  --url https://geekapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Veo3.1-quality-official",
    "prompt": "海豚在碧蓝海洋中跳跃，溅起水花，阳光洒在海面上",
    "duration": 8,
    "size": "16:9",
    "resolution": "1080p",
    "metadata": {
      "generateAudio": true,
      "negativePrompt": "模糊, 低质量"
    }
  }'

​
返回示例

200
{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "Veo3.1-quality-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}

​
响应字段

字段类型说明
idstring任务唯一标识符，用于查询任务状态
objectstring对象类型，固定为 generation.task
modelstring使用的模型名称
statusstring任务状态：queued / in_progress / completed / failed
progressinteger任务进度百分比（0–100）
created_atinteger任务创建时间戳（Unix 时间戳）
metadataobject任务元数据

​
查询任务状态

提交后，使用以下接口轮询任务进度： 
GET https://geekapis.com/v1/videos/generations/{task_id}