1. Video通用接口(持续开发中)
EZLINK AI API
  • 前言-模型兼容性(必读)
  • OpenAI官方SDK使用教程
  • 高并发批量请求示例
  • Claude Code最佳API配置教程指南
  • OpenAi Codex最佳API配置教程指南
  • Gemini CLI最佳API配置教程指南
  • OpenClaw 配置使用 API 教程
  • OpenCode 配置使用 API 教程
  • EZLINK AI API
  • 基础接口
    • Gemini(原生)
      • Gemini generateContent(非流式)
      • Gemini streamGenerateContent(流式)
    • 聊天接口(通用)
      POST
    • Claude (原生格式
      POST
    • responses接口(原生)
      POST
    • 创建嵌入
      POST
  • 可灵
    • OMNI video
      POST
    • 任务:文生视频
      POST
    • 任务:图生视频
      POST
    • 查询
      GET
    • 人脸识别
      POST
    • 对口型
      POST
    • 通用查询
      GET
    • motion-control
      POST
    • custom-elements
      POST
    • 自定义音色
      POST
    • 查询主体
      GET
    • 查询音色
      GET
    • 查询音色列表
      GET
    • 查询-动作控制
      GET
    • 查询文生视频
      GET
    • omni-image
      POST
    • 查询omni-images
      GET
    • 创建主体(新)
      POST
    • 查询主体 -单个
      GET
    • 查询主体 列表
      GET
    • OMNI video Copy
      POST
  • Flux
    • /v1/flux-2-pro
    • 查询flux
  • sora(原生)
    • 文生视频
    • 查询内容接口
    • 查询详情接口
  • 阿里万相
    • 图生视频
    • 查询任务
  • Video通用接口(持续开发中)
    • Veo视频生成
      POST
    • 可灵视频生成
      POST
    • 视频生成结果查询
      GET
  • 图片生成(image)
    • OpenAi
      • 图像生成 dall-e-2、dall-e-3
      • 图像生成 gpt-image
      • 图像编辑 gpt-image
    • Gemini
      • nano-banana参考尺寸
      • 图像生成 nano-banana
      • 图像编辑 nano-banana
    • 即梦AI
      • 即梦4.0-图片生成
      • 既梦4.0-图片编辑
      • 即梦3.0-图片生成
      • 既梦3.0-图片编辑
    • Qwen
      • 图像生成
      • 图像编辑
    • Grok
      • 图像生成
  • 查询令牌用量
    GET
  • 查询令牌限额
    GET
  • 查询账户信息
    GET
  • Schemas
    • Schemas
      • Veo3VideoGenerationRequest
      • VideoGenerationRequest
      • VeoVideoGenerationRequest
      • Veo3Instance
      • Veo3Image
      • VeoMediaObject
      • Veo3Parameters
      • VeoParameters
      • JimengVideoGenerationRequest
      • JimengContent
      • JimengImage
      • JimengImageUrl
      • JimengParameters
      • FluxImageGenerationRequest
    • GenerateContentRequest
    • Content
    • Part
    • GenerationConfig
    • SafetySetting
    • GenerateContentResponse
  1. Video通用接口(持续开发中)

Veo视频生成

POST
/v1/video/generations
使用 Google Veo 系列模型进行视频生成。请求体与 Vertex AI 官方 API 保持一致(透传),仅需额外添加 model 字段用于路由。

支持的模型#

Veo 2: veo-2.0-generate-001
Veo 3.0: veo-3.0-generate-001、veo-3.0-fast-generate-001、veo-3.0-generate-preview、veo-3.0-fast-generate-preview
Veo 3.1: veo-3.1-generate-preview、veo-3.1-fast-generate-preview、veo-3.1-generate-001、veo-3.1-fast-generate-001

请求体格式#

使用 instances 和 parameters 格式(与 Vertex AI 官方一致):
model:模型 ID
instances:实例数组,包含 prompt 和可选的 image、lastFrame、video、mask、referenceImages
parameters:生成参数
注意:本 API 仅支持 bytesBase64Encoded 方式传递媒体数据,不支持 gcsUri。

功能支持#

功能Veo 2Veo 3.0Veo 3.1
文生视频 (prompt)✅✅✅
图生视频 (image)✅✅✅
末帧控制 (lastFrame)✅ veo-2.0-generate-001❌✅
视频延长 (video)✅ veo-2.0-generate-001❌❌
遮罩编辑 (mask)✅ veo-2.0-generate-preview❌❌
素材参考图 (referenceImages)✅ veo-2.0-generate-exp❌✅ veo-3.1-generate-preview

媒体对象格式#

image / lastFrame / video 等字段使用扁平的 bytesBase64Encoded + mimeType 结构(不支持 gcsUri):
{"bytesBase64Encoded": "BASE64...", "mimeType": "image/jpeg"}
⚠️ 不要使用 Gemini API 的 inlineData 嵌套格式,否则会报 image is empty 错误。

参数说明#

durationSeconds(必填):Veo 2 支持 5-8 秒,Veo 3/3.1 支持 4、6、8 秒
generateAudio:Veo 3/3.1 必填
enhancePrompt:仅 Veo 2 支持
resizeMode:仅 Veo 3 系列图生视频时可用,可选 pad(默认)或 crop
resolution:仅 Veo 3/3.1 支持,可选 720p(默认)或 1080p
personGeneration:可选 allow_adult(默认)或 dont_allow
sampleCount:生成数量 1-4
seed:随机种子(0-4294967295)

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params

Body Params application/json

Examples
{
    "model": "veo-3.1-generate-preview",
    "instances": [
        {
            "prompt": "A cat playing piano in the rain, cinematic, 4K"
        }
    ],
    "parameters": {
        "aspectRatio": "16:9",
        "durationSeconds": 8,
        "generateAudio": true,
        "negativePrompt": "blurry, low quality",
        "personGeneration": "allow_adult",
        "sampleCount": 1
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.ezlinkai.com/v1/video/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "veo-3.1-generate-preview",
    "instances": [
        {
            "prompt": "A cat playing piano in the rain, cinematic, 4K"
        }
    ],
    "parameters": {
        "aspectRatio": "16:9",
        "durationSeconds": 8,
        "generateAudio": true,
        "negativePrompt": "blurry, low quality",
        "personGeneration": "allow_adult",
        "sampleCount": 1
    }
}'

Responses

🟢200OK
application/json
Veo视频生成任务提交成功
Body

Example
{
    "task_id": "veo3-20250714221020-668xc",
    "task_status": "succeed",
    "message": ""
}
Modified at 2026-03-19 13:54:26
Previous
查询任务
Next
可灵视频生成
Built with