Skip to main content
GET
/
kyyReactApiServer
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

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

​
KyyVideo2 Query Video Task

Use the task ID to query the status and results of KyyVideo2 video generation tasks.

​
Authentication

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

​
Path Parameters

​
id
string
required
Unique identifier for the video generation task, returned from the create task APIExample: video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd

​
Response Parameters

​
id
string
Unique identifier for the video generation task
​
object
string
Object type, always video
​
created
integer
Task creation timestamp
​
model
string
Model name used (kyyvideo2, kyyvideo2_fast, kyyvideo2_pro, kyyvideo2_fast_pro)
​
status
string
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
​
video_url
string
Generated video URL, returned when status is completed
​
error
string
Error message, returned when status is failed

​
Status Flow

1

queued

Task created and added to queue, waiting for processing
2

processing

Task is being processed, KyyVideo2 model is generating the video
3

completed

Task completed, video generated successfully, available via video_url

​
Polling Recommendations

Polling Strategy:
  • Recommended polling interval: 20-40 seconds
  • Fast models (kyyvideo2_fast, kyyvideo2_fast_pro) generate faster, can use shorter polling intervals
  • Avoid overly frequent requests to prevent rate limiting
  • Stop polling when status is completed or failed

​
Video URL Information

Important Notes:
  • Generated video URLs are typically valid for 24 hours
  • Download and save videos to your storage system promptly
  • Videos cannot be accessed after URL expiration
  • Video files are typically in MP4 format
  • Depending on the generateAudio parameter, videos may or may not contain audio

​
Generation Time Estimates

Standard Models

kyyvideo2 / kyyvideo2_proEstimated generation time: 2-5 minutes

Fast Models

kyyvideo2_fast / kyyvideo2_fast_proEstimated generation time: 1-3 minutes
Factors Affecting Generation Time:
  • Video duration: Longer duration requires more generation time
  • Model type: Fast models generate faster
  • Reference materials: Using multimodal references (images, videos, audio) may increase processing time
  • System load: Peak times may require longer queue times

​
Model Generation Speed Comparison

ModelAverage Generation TimeUse Case
kyyvideo22-5 minutesStandard quality, supports reference videos
kyyvideo2_fast1-3 minutesFast generation, supports reference videos
kyyvideo2_pro3-6 minutesHigh quality output
kyyvideo2_fast_pro2-4 minutesHigh quality fast generation
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

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