Skip to main content
POST
/
kyyReactApiServer
/
v1
/
vidu
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/vidu/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat dancing in the rain, cinematic style",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "queued",
  "error": null
}

​
Vidu Create Video Task

Create video generation tasks using Vidu’s AI models, supporting text-to-video, image-to-video, and first/last frame guidance modes.

​
Authentication

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

​
Model Introduction

Supported models:
  • viduq3-pro: Efficiently generates high-quality audio-visual content, making videos more vivid, vivid, and three-dimensional, with better results
  • viduq3-turbo: Compared to viduq3-pro, faster generation speed

​
Request Parameters

​
model
string
required
Model nameAvailable values:
  • viduq3-pro - Vidu Q3 Pro, better quality
  • viduq3-turbo - Vidu Q3 Turbo, faster speed
​
prompt
string
required
Video generation prompt describing the desired video contentExample: "A cat dancing in the rain, cinematic style"
​
duration
number
Video duration in seconds, default value depends on the model
  • viduq3-pro, viduq3-turbo: default 5 seconds
  • Available range: 1-16 seconds
​
aspect_ratio
string
Output video aspect ratio, default is 16:9Supported values:
  • 16:9 - Landscape
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Standard
  • 3:4 - Portrait standard
​
resolution
string
Output resolution, default is 720pSupported values:
  • 540p - Standard definition
  • 720p - High definition (default)
  • 1080p - Full HD

​
Image-to-Video Mode

​
first_image
string
First frame image URL (image-to-video scenario)Usage:
  • Use alone: image-to-video scenario
  • Use with last_image: first/last frame scenario
Format requirements: jpeg, png, webp Value type: Public URL
​
last_image
string
Last frame image URL (first/last frame scenario, must be used with first_image)Format requirements: jpeg, png, webp Value type: Public URL
Must be used together with first_image

​
Response Parameters

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

​
Use Cases

Text-to-Video

Generate videos using only prompt, no image guidance needed

Image-to-Video

Use first_image as the first frame to generate coherent video

First/Last Frame Guidance

Use both first_image and last_image for precise control of start and end

​
Vidu Features

Flexible Duration

Supports adjustable video duration from 1-16 seconds

Multiple Aspect Ratios

Supports 5 common video aspect ratios

Multiple Resolutions

Supports 540p, 720p, 1080p resolutions

Dual Model Selection

Pro version for better quality, Turbo version for faster speed
Best Practices:
  1. Video generation is asynchronous, use the returned id to query task status and results
  2. Clearly describe the desired visual effects and style in the prompt
  3. Choose the appropriate model:
    • viduq3-pro: Efficiently generates high-quality audio-visual content, better results
    • viduq3-turbo: Faster generation speed
  4. Select appropriate duration based on needs (1-16 seconds)
  5. Image URLs must be publicly accessible
Scenario Selection Recommendations:
  • Text-to-Video: Fully AI-created, suitable for creative exploration
  • Image-to-Video: Generated based on first frame image, suitable for scenarios with clear starting visuals
  • First/Last Frame Guidance: Precise control of start and end, suitable for scenarios requiring specific transition effects
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/vidu/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "A cat dancing in the rain, cinematic style",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "queued",
  "error": null
}