mingyanmingyan
wechatwechat
mingyan

VEO - Create Task

Create video generation tasks using VEO models with support for reference images and first/last frame guidance

POST/kyyReactApiServer/v1/veo/videos/

VEO Create Video Task

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

Authentication

Get Key
All requests require a Bearer token in the request header:
cURL
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

modelstringrequired
Model name
Available 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
promptstringrequired
Video generation prompt describing the desired video content
Example: "A cat dancing in the rain, cinematic style"
resolutionstring
Output resolution
Supported 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_ratiostring
Output video aspect ratio (pure ratio), defaults to 16:9
Supported 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_referencearray
Reference image URLs
Cannot 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_urlsarray
Reference image URLs
Cannot 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_imagestring
First frame image URL
Supported 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_imagestring
Last frame image URL, must be used with first_image
Supported 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

idstring
Unique identifier for the video generation task, used for subsequent status queries
objectstring
Object type, always video.generation
createdinteger
Task creation timestamp
modelstring
Model name used
statusstring
Task status:
  • queued - Queued
  • processing - Processing
errorstring
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