跳转到主要内容
POST
/
kyyReactApiServer
/
v1
/
veo
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/veo/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo_3_1_fast",
    "prompt": "A cat dancing in the rain, cinematic style",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "input_reference": [
      "https://example.com/reference1.jpg",
      "https://example.com/reference2.jpg"
    ]
  }'

{
  "id": "vgen_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "veo_3_1_fast",
  "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://docs.globalaiopc.com/llms.txt

Use this file to discover all available pages before exploring further.

​
VEO 创建视频任务

使用 VEO 的先进 AI 模型创建高质量视频生成任务，支持两种图片引导模式。

​
认证

所有请求都需要在请求头中包含 Bearer token： 
Authorization: Bearer {{key}}

​
基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

​
请求参数

​
model
string
必填
模型名称可选值：
  • veo_3_1_fast_stable - 720p/1080p，仅支持首尾帧
  • veo_3_1_pro_stable - 720p/1080p
  • veo_3_1_fast - 快速版，支持720p/1080p/4K
  • veo_3_1_pro - 高质量版，支持720p/1080p/4K
​
prompt
string
必填
视频生成提示词，描述所需的视频内容示例："A cat dancing in the rain, cinematic style"
​
resolution
string
输出分辨率支持的值：
  • 720p - 默认，所有 Veo 模型
  • 1080p - 支持 veo_3_1_fast_stable、veo_3_1_pro_stable、veo_3_1_fast、veo_3_1_pro
  • 4K - 支持 veo_3_1_fast、veo_3_1_pro
大小写兼容：支持 720p/720P/4K/4k 等任意格式
veo_3_1_fast_stable / veo_3_1_pro_stable 不支持 4K
​
aspect_ratio
string
输出视频比例（纯宽高比），默认为 16:9支持的值：
  • 16:9 - 横屏
  • 9:16 - 竖屏
分辨率通过 resolution 字段单独指定，aspect_ratio 不支持 -1080p/-4K 后缀

​
参考图片模式

​
input_reference
array
参考图片URL不可搭配首尾帧使用。支持模型：
  • veo_3_1_pro_stable（最多3张）
  • veo_3_1_fast（最多3张）
  • veo_3_1_pro
veo_3_1_fast_stable 仅支持首尾帧模式，不支持参考图模式
与 image_urls 二选一
​
image_urls
array
参考图片URL不可搭配首尾帧使用。支持模型：
  • veo_3_1_pro_stable（最多3张）
  • veo_3_1_fast（最多3张）
  • veo_3_1_pro
veo_3_1_fast_stable 仅支持首尾帧模式，不支持参考图模式
与 input_reference 二选一

​
首尾帧模式

​
first_image
string
首帧图片URL支持模型：
  • veo_3_1_fast_stable
  • veo_3_1_pro_stable
  • veo_3_1_fast
  • veo_3_1_pro
使用方式：
  • 单独使用：图生视频模式
  • 搭配 last_image 使用：首尾帧模式
与参考图片模式互斥
​
last_image
string
尾帧图片URL，需搭配 first_image 使用支持模型：
  • veo_3_1_fast_stable
  • veo_3_1_pro_stable
  • veo_3_1_fast
  • veo_3_1_pro
必须与 first_image 一起使用，与参考图片模式互斥

​
响应参数

​
id
string
视频生成任务的唯一标识符，用于后续查询任务状态
​
object
string
对象类型，固定为 video.generation
​
created
integer
任务创建时间戳
​
model
string
使用的模型名称
​
status
string
任务状态：
  • queued - 排队中
  • processing - 处理中
​
error
string
错误信息，当 status 为 failed 时返回

​
图片引导模式

VEO 支持两种互斥的图片引导模式：

参考图片模式

使用 input_reference 或 image_urls 提供最多 3 张参考图片，指导整体风格和内容

首尾帧模式

使用 first_image 和可选的 last_image 指定视频的精确开始和结束帧
重要： 两种模式不能同时使用，只能选择其中一种

​
参数选择规则

参数互斥规则：
  • 参考图片：input_reference 和 image_urls 二选一
  • 引导模式：参考图片模式 OR 首尾帧模式，不能同时使用
  • 模型限制：veo_3_1_fast_stable 仅支持首尾帧模式，veo_3_1_fast_stable / veo_3_1_pro_stable 不支持 4K

​
VEO 特性

多分辨率支持

支持 720p、1080p、4K 多种分辨率输出

双引导模式

支持参考图片和首尾帧两种引导方式

多模型选择

提供 fast_stable、pro_stable、fast、pro 四种模型

灵活控制

首尾帧模式提供精确的开始和结束控制
最佳实践：
  1. 视频生成为异步处理，需要通过返回的 id 查询任务状态和结果
  2. 在提示词中明确描述所需的视觉效果和风格
  3. 选择合适的模型：
    • veo_3_1_fast_stable：720p/1080p，仅支持首尾帧
    • veo_3_1_pro_stable：720p/1080p
    • veo_3_1_fast：快速版，支持720p/1080p/4K
    • veo_3_1_pro：高质量版，支持720p/1080p/4K
  4. 选择合适的引导模式：
    • 参考图片模式：适合风格引导（veo_3_1_pro_stable、veo_3_1_fast、veo_3_1_pro）
    • 首尾帧模式：适合精确控制开始和结束（所有模型）
  5. 根据模型选择合适的分辨率
引导模式选择建议：
  • 参考图片模式：当你想要整体风格一致但允许创意变化时使用（veo_3_1_pro_stable、veo_3_1_fast、veo_3_1_pro 支持）
  • 首尾帧模式：当你需要精确控制视频的开始和结束画面时使用（所有模型支持）
  • 分辨率选择：根据模型能力和需求选择，veo_3_1_fast_stable / veo_3_1_pro_stable 不支持 4K
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/veo/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo_3_1_fast",
    "prompt": "A cat dancing in the rain, cinematic style",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "input_reference": [
      "https://example.com/reference1.jpg",
      "https://example.com/reference2.jpg"
    ]
  }'

{
  "id": "vgen_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "veo_3_1_fast",
  "status": "queued"
}