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

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

​
KyyVideo2 Create Video Task

Create high-quality video generation tasks using KyyVideo2’s advanced AI models with support for multiple model options and multimodal reference inputs.

​
Authentication

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

​
Request Parameters

​
model
string
required
Model name, available options:
  • kyyvideo2 - Standard model (supports reference videos)
  • kyyvideo2_fast - Fast model (supports reference videos)
  • kyyvideo2_pro - Pro model (no reference videos support)
  • kyyvideo2_fast_pro - Fast Pro model (no reference videos support)
​
prompt
string
required
Video generation prompt describing the desired video contentExample: "A cat dancing in the rain, cinematic style"
​
duration
integer
Video duration in seconds, default 5 seconds, range 4-15 seconds
​
first_image
string
First frame image URL for image-to-video scenariosUse Cases:
  • Standalone: Image-to-video with first frame
  • Combined with last_image: First and last frame scenario
Format Requirements:
  • Format: jpeg, png, webp, bmp, tiff, gif
  • Aspect ratio (width/height): 0.4 ~ 2.5
  • Size: 300-6000 px
  • Value type: Public URL or asset ID (asset://assetID)
Mutually exclusive with referenceImages/referenceVideos/referenceAudios
​
last_image
string
Last frame image URL for first and last frame scenarioFormat Requirements:
  • Format: jpeg, png, webp, bmp, tiff, gif
  • Aspect ratio (width/height): 0.4 ~ 2.5
  • Size: 300-6000 px
  • Value type: Public URL or asset ID (asset://assetID)
Must be used together with first_image
​
aspect_ratio
string
Output video aspect ratio, default 16:9Available options:
  • 16:9 - Landscape
  • 4:3 - Standard
  • 1:1 - Square
  • 3:4 - Portrait
  • 9:16 - Portrait
  • 21:9 - Ultra-wide
  • adaptive - Adaptive
​
generateAudio
boolean
Whether to generate synchronized audio, default true
  • true: Output video includes synchronized audio
  • false: Output video is silent
​
referenceAudios
array
Multimodal reference audio listFormat Requirements:
  • Format: wav, mp3
  • Duration: Single audio 2-15 seconds, max 3 segments, total duration ≤ 15 seconds
  • Size: Single ≤ 15 MB
  • Value type: Public URL or asset ID (asset://assetID)
Mutually exclusive with first_image/last_image
​
referenceImages
array
Multimodal reference image listFormat Requirements:
  • Quantity: 1-9 images
  • Format: jpeg, png, webp, bmp, tiff, gif
  • Aspect ratio (width/height): 0.4 ~ 2.5
  • Size: 300-6000 px
  • Value type: Public URL or asset ID (asset://assetID)
Images involving faces or virtual avatars must be uploaded to the asset library for review first
Mutually exclusive with first_image/last_image
​
referenceVideos
array
Multimodal reference video listFormat Requirements:
  • Resolution: 480p, 720p
  • Duration: Single video 2-15 seconds, max 3 videos, total duration ≤ 15 seconds
  • Aspect ratio (width/height): 0.4 ~ 2.5
  • Size: 300-6000 px
  • Value type: Public URL or asset ID (asset://assetID)
System automatically selects the optimal backend model
Mutually exclusive with first_image/last_image

​
Response Parameters

​
id
string
Unique identifier for the video generation task, used for subsequent status queries
​
object
string
Object type, always 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

​
Model Features

kyyvideo2

Standard model, supports reference videos, suitable for regular video generation

kyyvideo2_fast

Fast model, supports reference videos, faster generation speed

kyyvideo2_pro

Pro model, no reference videos support, higher quality

kyyvideo2_fast_pro

Fast Pro model, no reference videos support, balances speed and quality

​
Parameter Selection Rules

Mutually Exclusive Parameters:
  • First/Last Frame Scenario: When using first_image and last_image, cannot use referenceImages, referenceVideos, referenceAudios
  • Multimodal Reference: When using referenceImages, referenceVideos, referenceAudios, cannot use first_image, last_image

​
Model Feature Comparison

ModelReference Video SupportGeneration SpeedVideo Quality
kyyvideo2✅ SupportedStandardStandard
kyyvideo2_fast✅ SupportedFastStandard
kyyvideo2_pro❌ Not SupportedStandardHigh Quality
kyyvideo2_fast_pro❌ Not SupportedFastHigh Quality
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 the appropriate model based on needs: select standard or fast models when reference videos are needed, choose Pro models for quality
  4. Reference images involving faces must be uploaded to the asset library for review first
  5. Set reasonable video duration (4-15 seconds), shorter duration generates faster
Prompt Suggestions:
  • Include specific scene descriptions
  • Add style keywords (e.g., “cinematic style”, “artistic style”, “realistic style”)
  • Describe actions and movement patterns
  • Specify lighting and color preferences
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/kyyvideo2/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kyyvideo2",
    "prompt": "A cat dancing in the rain, cinematic style",
    "duration": 10,
    "aspect_ratio": "16:9",
    "generateAudio": true
  }'

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