mingyan

Happy Horse - Query Task

Query the status and result of Happy Horse video generation tasks

GET/kyyReactApiServer/v1/result/{id}

Happy Horse Query Task

Use the task ID to query the status and result of a Happy Horse video generation task. This query API applies to Happy Horse text-to-video, first-frame image-to-video, and reference-to-video tasks.

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.

Path Parameters

idstringrequired

Unique identifier of the video task, returned by the create task API.

The create API returns the field id directly. Use that value as the id here.

Response Parameters

idstring

Unique identifier of the video task.

objectstring

Object type. Always video.

createdinteger

Task creation timestamp.

modelstring

Model name used for generation, such as happyhorse-1.0-t2v, happyhorse-1.0-i2v, or happyhorse-1.0-r2v.

statusstring

Task status:

queued - Queued
processing - Processing
completed - Completed
failed - Failed

video_urlstring

Generated or edited video URL, returned when the task is completed.

actualDurationnumber

Actual output duration in seconds, returned when the task is completed.

errorstring

Error message, returned when the task is failed.

Status Flow

queued

The task has been created and added to the queue.

processing

Happy Horse is generating the video.

completed

The task completed successfully and the result is available through video_url.

Polling Recommendations

Polling strategy:

Recommended polling interval: 30-60 seconds
Completion time depends on the model, duration, and reference image count
Stop polling when status becomes completed or failed

Important:

The {id} path parameter must use the id returned by the create API
Generated result URLs are usually temporary, so save them promptly