Model Centermingyan

HappyHorse-1.1 Image-to-Video

POST/kyyReactApiServer/v2/model-center/tasks

Model information

Field	Value
Model ID (`model`)	`happyhorse-1.1-i2v`
Model name	HappyHorse-1.1 Image-to-Video
Model type	Video models
Set the request `model` field to the Model ID shown above. Using the model name will fail to resolve the model.

Authentication

Get Key

All requests must include a Bearer token in the request headers:

cURL

Authorization: Bearer <API_KEY>

Request parameters

Send the following fields in the JSON request body. model is required — use the Model ID from the Model information section above.

promptstringrequired

Prompt

支持任何语言输入，长度不超过5000个非中文字符或2500个中文字符，超过部分将自动截断。

Minimum：1

durationinteger

Duration

Generated video duration.

Range：3 – 15

Default：5

resolutionstring

Resolution

Output resolution tier.

Allowed values：720P, 1080P

Default：1080P

seedinteger

Seed

Deterministic generation seed.

Range：0 – 2147483647

first_imageimage[]required

First frame

图生视频首帧输入。

格式：JPEG、JPG、PNG、WEBP。

分辨率：宽和高不小于300像素。

宽高比：1:2.5～2.5:1。

文件大小：不超过20MB。

Range：1 – 1

Items：1 - 1

Provide a publicly accessible resource URL.

watermarkboolean

Watermark

Whether to add provider or platform watermark.

Default：false

Response contract

Task status is normalized to queued, processing, completed, or failed. Result URLs are returned only when status is completed;

Field	Description
`id`	Task ID used to poll status and results.
`object`	Resource type, usually `video` for this model.
`created`	Task creation time as a Unix timestamp in seconds.
`model`	Model name used for this request.
`status`	`queued`, `processing`, `completed`, or `failed`.
`progress`	Task progress, usually returned by the query API.
`result_url`	Generic result URL, returned only after completion.
`video_url`	Typed result URL for this resource, returned only after completion.
`amount`	Credits consumed by this task.
`actualDuration`	Duration used by this task.
`error`	Error message on failure; usually `null` while queued, processing, or completed.

Query task result

Generation tasks run asynchronously. The submit endpoint returns a task id; poll the query endpoint below with that id until status becomes completed or failed.

http

GET https://zcbservice.aizfw.cn/kyyReactApiServer/v2/model-center/tasks/{id}
Authorization: Bearer <API_KEY>

idstringrequired

The task ID returned by the submit endpoint.

When status is completed, the result URL is returned via result_url and video_url. See the Response contract above for the remaining fields.

Poll every 5–10 seconds and stop once status is completed or failed. Result URLs expire, so download and store them promptly.