Google Vertex AI API: Generate Videos ​

提交生成请求： ​

POST https://openqiao.com/api/vertex-ai/v1/publishers/{provider}/models/{model}:predictLongRunning

轮询任务状态： ​

POST https://openqiao.com/api/vertex-ai/v1/publishers/{provider}/models/{model}:fetchPredictOperation

Generate Videos 接口通过 Google Vertex AI 协议生成视频。开桥聚合了 Google Veo、字节跳动 Seedance、阿里 DashScope、SkyReels 等视频生成模型，均可通过统一的 Vertex AI 协议调用。

本接口对应 Google Gen AI SDK 中的 generate_videos / generateVideos 方法。调用时请将 Base URL 设置为 https://openqiao.com/api/vertex-ai，并使用开桥 API Key 鉴权。

更多使用示例请参考 视频生成使用指南。

支持的模型 ​

Path parameters ​

provider string * ​

模型供应商标识。对应模型名称中 / 前的部分，例如 google/veo-3.1-generate-001 中的 google。

model string * ​

模型名称。对应模型名称中 / 后的部分，例如 google/veo-3.1-generate-001 中的 veo-3.1-generate-001。

鉴权参数 ​

api_key string * ​

开桥 API 密钥，用于身份鉴权。

vertexai boolean * ​

必须设置为 true 以启用 Vertex AI 协议。

http_options.base_url string * ​

开桥 Vertex AI 端点：https://openqiao.com/api/vertex-ai。

http_options.api_version string * ​

API 版本，设置为 v1。

文生视频请求参数 ​

以下为 generate_videos / generateVideos SDK 方法的参数说明。SDK 会自动将这些参数转换为 Vertex AI REST 格式发送给开桥。

prompt string * ​

视频内容的文本描述。建议包含主体、动作、环境和光线等要素，使用清晰具体的描述。

model string * ​

用于视频生成的模型。格式为 {provider}/{model}，例如 google/veo-3.1-generate-001。

config GenerateVideosConfig 可选 ​

视频生成配置对象，包含以下字段：

aspectRatio string 可选 ​

视频宽高比。不同供应商支持的值可能不同。

可选值：

• 16:9（横屏，默认）
• 9:16（竖屏）
• 1:1（正方形）

REST 对应字段：parameters.aspectRatio

resolution string 可选 ​

视频分辨率。仅部分模型支持。

可选值：

• 720p
• 1080p

REST 对应字段：parameters.resolution

durationSeconds integer 可选 ​

视频时长（秒）。Google Veo 支持 5 或 8 秒，其他供应商支持范围可能不同。

可选值：

• 5
• 8

REST 对应字段：parameters.durationSeconds

generateAudio boolean 可选 ​

是否生成音频轨道。设置为 true 时，模型会根据视频内容自动生成配套音频。

REST 对应字段：parameters.generateAudio

negativePrompt string 可选 ​

负面提示词，描述不希望出现在视频中的内容。

REST 对应字段：parameters.negativePrompt

enhancePrompt boolean 可选 ​

是否启用提示词增强。开启后模型会自动优化提示词以提升视频质量。

REST 对应字段：parameters.enhancePrompt

personGeneration string 可选 ​

人物生成控制。仅 Google Veo 模型支持。

可选值：

• dont_allow
• allow_adult

REST 对应字段：parameters.personGeneration

numberOfVideos integer 可选 ​

要生成的视频数量。默认为 1。

SDK 字段名：Python number_of_videos，TypeScript numberOfVideos。

REST 对应字段：parameters.sampleCount

seed integer 可选 ​

随机种子，用于复现生成结果。

REST 对应字段：parameters.seed

fps integer 可选 ​

视频帧率。仅部分供应商支持。

REST 对应字段：parameters.fps

图生视频请求参数 ​

除文生视频外，还支持传入图片作为起始帧/结束帧，结合文本提示词生成视频。

image Image * ​

起始帧图片对象。

• image_bytes bytes *：图片的二进制数据。
• mime_type string *：图片 MIME 类型，如 image/png、image/jpeg。

REST 对应字段：instances[0].image

last_frame Image 可选 ​

结束帧图片对象。与起始帧配合使用，模型会生成从起始帧到结束帧的过渡动画。格式同 image。

SDK 字段名：Python last_frame，TypeScript lastFrame。

REST 对应字段：instances[0].lastFrame

audio Audio 可选 ​

参考音频对象。仅 bytedance/doubao-seedance-2.0（字节跳动 Seedance 2）支持。模型会以传入的音频作为参考，使生成视频的画面节奏、口型或动作与音频内容对齐。

• bytesBase64Encoded string：音频的 base64 编码数据。
• gcsUri string：音频文件的 URL（与 bytesBase64Encoded 二选一）。
• mimeType string：音频 MIME 类型，如 audio/mpeg、audio/wav。

REST 对应字段：audio（请求体顶层字段，与 instances、parameters 同级）

prompt string 可选 ​

描述图片中的内容应如何运动或变化的文本提示词。

model string * ​

同文生视频。

config GenerateVideosConfig 可选 ​

同文生视频配置。

Response ​

提交请求响应（Operation 对象） ​

提交视频生成请求后，返回一个 Operation 对象，用于追踪生成状态。

name string ​

Operation 标识符，用于后续轮询状态。

done boolean ​

生成是否完成。未完成时此字段可能不存在或为 false。

生成完成响应 ​

当 done 为 true 时，response 中包含生成结果。

response.videos array<Video> ​

生成的视频列表。

• gcsUri string：视频下载 URL。
• bytesBase64Encoded string：视频的 base64 编码数据（部分供应商返回）。
• mimeType string：视频 MIME 类型，通常为 video/mp4。

response.raiMediaFilteredCount integer ​

被内容审核拦截的视频数量。

response.raiMediaFilteredReasons array<string> ​

内容审核拦截的原因列表。

生成失败响应 ​

当生成失败时，raiMediaFilteredCount 大于 0，raiMediaFilteredReasons 中包含错误信息。

# Step 1: 提交视频生成请求
curl -X POST "https://openqiao.com/api/vertex-ai/v1/publishers/google/models/veo-3.1-generate-001:predictLongRunning" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instances": [{
      "prompt": "A golden retriever running on the beach at sunset"
    }],
    "parameters": {
      "aspectRatio": "16:9",
      "durationSeconds": 8,
      "generateAudio": true
    }
  }'

# 响应中包含 operation name，用于轮询
# {"name": "publishers/google/models/veo-3.1-generate-001/operations/abc123"}

# Step 2: 轮询任务状态（每 15 秒一次）
curl -X POST "https://openqiao.com/api/vertex-ai/v1/publishers/google/models/veo-3.1-generate-001:fetchPredictOperation" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName": "publishers/google/models/veo-3.1-generate-001/operations/abc123"}'

const { GoogleGenAI } = require("@google/genai");

const client = new GoogleGenAI({
  apiKey: process.env.OPENQIAO_API_KEY, 
  vertexai: true,
  httpOptions: {
    baseUrl: "https://openqiao.com/api/vertex-ai", 
    apiVersion: "v1",
  },
});

// Step 1: 提交视频生成请求
let operation = await client.models.generateVideos({
  model: "google/veo-3.1-generate-001",
  prompt: "A golden retriever running on the beach at sunset",
  config: {
    aspectRatio: "16:9",
    durationSeconds: 8,
    generateAudio: true,
  },
});

// Step 2: 轮询等待生成完成
while (!operation.done) {
  await new Promise((r) => setTimeout(r, 15000));
  operation = await client.operations.get(operation);
}

// Step 3: 获取生成结果
for (const video of operation.response.generatedVideos) {
  console.log("Video URL:", video.video.uri);
}

from google import genai
from google.genai import types
import time

client = genai.Client(
    api_key="$OPENQIAO_API_KEY",  
    vertexai=True,
    http_options=types.HttpOptions(
        api_version="v1",
        base_url="https://openqiao.com/api/vertex-ai"
    ),
)

# Step 1: 提交视频生成请求
operation = client.models.generate_videos(
    model="google/veo-3.1-generate-001",
    prompt="A golden retriever running on the beach at sunset",
    config=types.GenerateVideosConfig(
        aspectRatio="16:9",
        durationSeconds=8,
        generateAudio=True,
    ),
)

# Step 2: 轮询等待生成完成
while not operation.done:
    time.sleep(15)
    operation = client.operations.get(operation)

# Step 3: 获取生成结果
for video in operation.response.generated_videos:
    print("Video:", video)

// 提交请求后返回（生成中）
{
  "name": "publishers/google/models/veo-3.1-generate-001/operations/abc123"
}

// 轮询完成后返回
{
  "name": "publishers/google/models/veo-3.1-generate-001/operations/abc123",
  "done": true,
  "response": {
    "videos": [
      {
        "bytesBase64Encoded": "AAAAIGZ0eXBpc29t...",
        "mimeType": "video/mp4"
      }
    ]
  }
}

# Step 1: 提交图生视频请求（图片以 base64 编码传入）
curl -X POST "https://openqiao.com/api/vertex-ai/v1/publishers/google/models/veo-3.1-generate-001:predictLongRunning" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instances": [{
      "prompt": "The dog stands up and runs toward the ocean waves",
      "image": {
        "bytesBase64Encoded": "<BASE64_IMAGE_DATA>",
        "mimeType": "image/png"
      }
    }],
    "parameters": {
      "aspectRatio": "16:9",
      "durationSeconds": 8
    }
  }'

# Step 2: 轮询任务状态
curl -X POST "https://openqiao.com/api/vertex-ai/v1/publishers/google/models/veo-3.1-generate-001:fetchPredictOperation" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName": "publishers/google/models/veo-3.1-generate-001/operations/xyz789"}'

const { GoogleGenAI } = require("@google/genai");
const fs = require("fs");

const client = new GoogleGenAI({
  apiKey: process.env.OPENQIAO_API_KEY, 
  vertexai: true,
  httpOptions: {
    baseUrl: "https://openqiao.com/api/vertex-ai", 
    apiVersion: "v1",
  },
});

const imageBytes = fs.readFileSync("input_image.png");

// Step 1: 提交图生视频请求
let operation = await client.models.generateVideos({
  model: "google/veo-3.1-generate-001",
  image: {
    imageBytes: imageBytes,
    mimeType: "image/png",
  },
  prompt: "The dog stands up and runs toward the ocean waves",
  config: {
    aspectRatio: "16:9",
    durationSeconds: 8,
  },
});

// Step 2: 轮询等待生成完成
while (!operation.done) {
  await new Promise((r) => setTimeout(r, 15000));
  operation = await client.operations.get(operation);
}

// Step 3: 获取生成结果
for (const video of operation.response.generatedVideos) {
  console.log("Video URL:", video.video.uri);
}

from google import genai
from google.genai import types
import time

client = genai.Client(
    api_key="$OPENQIAO_API_KEY",  
    vertexai=True,
    http_options=types.HttpOptions(
        api_version="v1",
        base_url="https://openqiao.com/api/vertex-ai"
    ),
)

with open("input_image.png", "rb") as f:
    image_bytes = f.read()

# Step 1: 提交图生视频请求
operation = client.models.generate_videos(
    model="google/veo-3.1-generate-001",
    image=types.Image(image_bytes=image_bytes, mime_type="image/png"),
    prompt="The dog stands up and runs toward the ocean waves",
    config=types.GenerateVideosConfig(
        aspectRatio="16:9",
        durationSeconds=8,
    ),
)

# Step 2: 轮询等待生成完成
while not operation.done:
    time.sleep(15)
    operation = client.operations.get(operation)

# Step 3: 获取生成结果
for video in operation.response.generated_videos:
    print("Video:", video)

{
  "name": "publishers/google/models/veo-3.1-generate-001/operations/xyz789",
  "done": true,
  "response": {
    "videos": [
      {
        "bytesBase64Encoded": "AAAAIGZ0eXBpc29t...",
        "mimeType": "video/mp4"
      }
    ]
  }
}

Seedance 2 参考音频示例 ​

bytedance/doubao-seedance-2.0 支持传入参考音频，使生成视频与音频内容对齐。参考音频通过请求体顶层的 audio 字段传入（与 instances、parameters 同级），需与参考图（referenceImages）和/或参考视频（video）搭配，不能与首帧 image 同时使用。

# Step 1: 提交带参考音频的视频生成请求
curl -X POST "https://openqiao.com/api/vertex-ai/v1/publishers/bytedance/models/doubao-seedance-2.0:predictLongRunning" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instances": [{
      "prompt": "The singer performs on stage in sync with the music",
      "referenceImages": [{
        "image": {
          "bytesBase64Encoded": "<BASE64_IMAGE_DATA>",
          "mimeType": "image/png"
        },
        "referenceType": "asset"
      }]
    }],
    "parameters": {
      "resolution": "720p",
      "durationSeconds": 5
    },
    "audio": {
      "bytesBase64Encoded": "<BASE64_AUDIO_DATA>",
      "mimeType": "audio/mpeg"
    }
  }'

# Step 2: 轮询任务状态
curl -X POST "https://openqiao.com/api/vertex-ai/v1/publishers/bytedance/models/doubao-seedance-2.0:fetchPredictOperation" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName": "publishers/bytedance/models/doubao-seedance-2.0/operations/aud123"}'

{
  "name": "publishers/bytedance/models/doubao-seedance-2.0/operations/aud123",
  "done": true,
  "response": {
    "videos": [
      {
        "bytesBase64Encoded": "AAAAIGZ0eXBpc29t...",
        "mimeType": "video/mp4"
      }
    ]
  }
}