Skip to main content
POST
/
kyyReactApiServer
/
v1
/
veo
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/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 Create Video Task

Create high-quality video generation tasks using VEO’s advanced AI models with support for two image guidance modes.

​
Authentication

All requests require a Bearer token in the request header: 
Authorization: Bearer {{key}}

​
Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

​
Request Parameters

​
model
string
required
Model nameAvailable options:
  • veo_3_1_fast_stable - 720p/1080p, first/last frame only
  • veo_3_1_pro_stable - 720p/1080p
  • veo_3_1_fast - Fast version, supports 720p/1080p/4K
  • veo_3_1_pro - High-quality version, supports 720p/1080p/4K
​
prompt
string
required
Video generation prompt describing the desired video contentExample: "A cat dancing in the rain, cinematic style"
​
resolution
string
Output resolutionSupported values:
  • 720p - Default, all Veo models
  • 1080p - Supported by veo_3_1_fast_stable, veo_3_1_pro_stable, veo_3_1_fast, veo_3_1_pro
  • 4K - Supported by veo_3_1_fast, veo_3_1_pro
Case insensitive: supports 720p/720P/4K/4k and other formats
veo_3_1_fast_stable / veo_3_1_pro_stable do not support 4K
​
aspect_ratio
string
Output video aspect ratio (pure ratio), defaults to 16:9Supported values:
  • 16:9 - Landscape
  • 9:16 - Portrait
Resolution is specified separately via the resolution field, aspect_ratio does not support -1080p/-4K suffixes

​
Reference Image Mode

​
input_reference
array
Reference image URLsCannot be used with first/last frame mode.Supported models:
  • veo_3_1_pro_stable (up to 3 images)
  • veo_3_1_fast (up to 3 images)
  • veo_3_1_pro
veo_3_1_fast_stable only supports first/last frame mode, does not support reference image mode
Choose either this or image_urls
​
image_urls
array
Reference image URLsCannot be used with first/last frame mode.Supported models:
  • veo_3_1_pro_stable (up to 3 images)
  • veo_3_1_fast (up to 3 images)
  • veo_3_1_pro
veo_3_1_fast_stable only supports first/last frame mode, does not support reference image mode
Choose either this or input_reference

​
First/Last Frame Mode

​
first_image
string
First frame image URLSupported models:
  • veo_3_1_fast_stable
  • veo_3_1_pro_stable
  • veo_3_1_fast
  • veo_3_1_pro
Usage modes:
  • Used alone: Image-to-video mode
  • Used with last_image: First/last frame mode
Mutually exclusive with reference image mode
​
last_image
string
Last frame image URL, must be used with first_imageSupported models:
  • veo_3_1_fast_stable
  • veo_3_1_pro_stable
  • veo_3_1_fast
  • veo_3_1_pro
Must be used with first_image, mutually exclusive with reference image mode

​
Response Parameters

​
id
string
Unique identifier for the video generation task, used for subsequent status queries
​
object
string
Object type, always video.generation
​
created
integer
Task creation timestamp
​
model
string
Model name used
​
status
string
Task status:
  • queued - Queued
  • processing - Processing
​
error
string
Error message, returned when status is failed

​
Image Guidance Modes

VEO supports two mutually exclusive image guidance modes:

Reference Image Mode

Use input_reference or image_urls to provide up to 3 reference images for overall style and content guidance

First/Last Frame Mode

Use first_image and optional last_image to specify precise start and end frames of the video
Important: The two modes cannot be used simultaneously, choose only one

​
Parameter Selection Rules

Mutually Exclusive Parameters:
  • Reference images: Choose either input_reference or image_urls
  • Guidance modes: Reference image mode OR first/last frame mode, cannot use both
  • Model limitations: veo_3_1_fast_stable only supports first/last frame mode, veo_3_1_fast_stable / veo_3_1_pro_stable do not support 4K

​
VEO Features

Multi-Resolution Support

Supports 720p, 1080p, 4K multiple resolution outputs

Dual Guidance Modes

Supports both reference image and first/last frame guidance

Multiple Model Options

Provides fast_stable, pro_stable, fast, and pro models

Flexible Control

First/last frame mode provides precise start and end control
Best Practices:
  1. Video generation is asynchronous, use the returned id to query task status and results
  2. Clearly describe desired visual effects and style in the prompt
  3. Choose appropriate model:
    • veo_3_1_fast_stable: 720p/1080p, first/last frame only
    • veo_3_1_pro_stable: 720p/1080p
    • veo_3_1_fast: Fast version, supports 720p/1080p/4K
    • veo_3_1_pro: High-quality version, supports 720p/1080p/4K
  4. Choose appropriate guidance mode:
    • Reference image mode: Suitable for style guidance (veo_3_1_pro_stable, veo_3_1_fast, veo_3_1_pro)
    • First/last frame mode: Suitable for precise start and end control (all models)
  5. Select appropriate resolution based on model capabilities
Guidance Mode Selection:
  • Reference Image Mode: Use when you want overall style consistency but allow creative variation (veo_3_1_pro_stable, veo_3_1_fast, veo_3_1_pro support)
  • First/Last Frame Mode: Use when you need precise control over video start and end frames (all models support)
  • Resolution Selection: Choose based on model capabilities and requirements, veo_3_1_fast_stable / veo_3_1_pro_stable do not support 4K
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/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"
}