mingyan

Happy Horse First Frame to Video - Create Task

Create a Happy Horse first-frame image-to-video task with happyhorse-1.0-i2v

POST/kyyReactApiServer/v1/happyhorse-i2v/videos

Happy Horse First-Frame Image-to-Video Create Task

Create a first-frame image-to-video task with happyhorse-1.0-i2v. The output aspect ratio follows the first-frame image, so this API does not accept ratio.

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.

Request Parameters

modelbodystringrequired

Model name. Always use happyhorse-1.0-i2v.

promptbodystringrequired

Video generation prompt. The maximum length is 2500 Chinese characters or 5000 non-Chinese characters.

first_imagebodystringrequired

First-frame image public URL. Only HTTP / HTTPS URLs are supported; Base64 input is not supported currently.

Image limits:

Formats: JPEG, JPG, PNG, WEBP
Width and height must both be at least 300 pixels
Aspect ratio: 1:2.5 to 2.5:1
File size: up to 20MB

durationbodyinteger

Video duration in seconds. Defaults to 5; supported range is 3-15.

resolutionbodystring

Output resolution. Defaults to 720P; available values are 720P and 1080P.

seedbodyinteger

Random seed from 0 to 2147483647. Defaults to 0.

Response Parameters

idstring

Unique identifier of the video generation task. Use it to query task status later.

objectstring

Object type. Always video.

createdinteger

Task creation timestamp.

modelstring

Model name used to create the task.

statusstring

Task status. On successful creation, it is always queued.

errorstring

Error information. It is usually null when task creation succeeds.

Important:

first_image must be a public URL
Base64 input is not supported for this upstream integration currently
The output aspect ratio follows the first-frame image