Query task (HappyHorse)

curl --request GET \
  --url https://api.aiid.edu.kg/api/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "output": {
    "task_id": "<string>",
    "submit_time": "<string>",
    "scheduled_time": "<string>",
    "end_time": "<string>",
    "video_url": "<string>",
    "code": "<string>",
    "message": "<string>"
  },
  "usage": {
    "duration": 123,
    "SR": 123,
    "video_count": 123
  },
  "request_id": "<string>"
}

Video generation HappyHorse

Query task (HappyHorse)

This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats).

HappyHorse Alibaba video generation API, with public paths following the official DashScope protocol.

Supports 5 external models: happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, and happyhorse-1.0-video-edit. Among them, happyhorse-1.0 is an aggregated model and requires mode to distinguish t2v, i2v, r2v, and video_edit.

The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass X-DashScope-Async explicitly; it is handled by the gateway or the official channel adapter layer.

Provides the public request skeleton, task query structure, and recommended validation template for the HappyHorse Alibaba official video generation format; the public paths keep the official endpoint format.

Supported models: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit

Unified request fields:

model (string, required): HappyHorse external model name. The aggregated model happyhorse-1.0 must be used with mode.
mode (string, optional): Aggregated model mode; common values are t2v, i2v, r2v, and video_edit. You can omit this for fixed submodels.
input.prompt (string, required): Prompt for video generation or editing.
input.media (array[object], optional): Multimedia input. Use first_frame for image-to-video, reference_image for reference-to-video, and video plus optional reference_image for video editing.
parameters.duration (integer, optional): Generation duration, billed by second.
parameters.resolution (string, optional): Output resolution; common values are 720P and 1080P.
parameters.ratio (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video.
parameters.watermark (boolean, optional): Whether to add a watermark.
parameters.seed (integer, optional): Random seed.

Common model/mode differences:

HappyHorse 聚合模型: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model.
HappyHorse 文生视频: Supports model happyhorse-1.0-t2v; official-format text-to-video.
HappyHorse 首帧图生视频: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video.
HappyHorse 参考生视频: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video.
HappyHorse 视频编辑: Supports model happyhorse-1.0-video-edit; official-format video editing.

GET

api

tasks

{task_id}

Query task (HappyHorse)

curl --request GET \
  --url https://api.aiid.edu.kg/api/v1/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'

{
  "output": {
    "task_id": "<string>",
    "submit_time": "<string>",
    "scheduled_time": "<string>",
    "end_time": "<string>",
    "video_url": "<string>",
    "code": "<string>",
    "message": "<string>"
  },
  "usage": {
    "duration": 123,
    "SR": 123,
    "video_count": 123
  },
  "request_id": "<string>"
}

Authorizations

Authorization

string

header

required

Use Bearer Token authentication. Format: Authorization: Bearer sk-xxxxxx

Path Parameters

task_id

string

required

Task ID, from the id returned when creating the task.

Response

200 - application/json

Query successful

output

object

Hide child attributes

output.task_id

string

The task ID returned when creating a task, used to query the task.

output.task_status

enum<string>

Task status, common values PENDING, RUNNING, SUCCEEDED, FAILED.

Available options:

PENDING,

RUNNING,

SUCCEEDED,

FAILED,

UNKNOWN

output.submit_time

string

output.scheduled_time

string

output.end_time

string

output.video_url

string<uri>

The URL of the generated video after the task succeeds.

output.code

string

output.message

string

usage

object

Hide child attributes

usage.duration

integer

Billable duration, in seconds.

usage.SR

integer

Output resolution levels.

usage.video_count

integer

request_id

string

Create video(HappyHorse)Kling Image-to-Video