GlobalAiOpc

Happy Horse Reference to Video - Create Task

Create a Happy Horse reference-to-video task with happyhorse-1.0-r2v

POST/kyyReactApiServer/v1/happyhorse-r2v/videos

Happy Horse Reference-to-Video Create Task

Create a reference-to-video task with happyhorse-1.0-r2v. Use referenceImages to provide image references, and refer to them in the prompt as [Image 1], [Image 2], and so on.

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-r2v.

promptbodystringrequired

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

referenceImagesbodyarrayrequired

Reference image URL array. Supports 1-9 images.

Image limits:

Formats: JPEG, JPG, PNG, WEBP
Recommended quality: 720P or above
Short side should be at least 400 pixels
File size: up to 20MB

durationbodyinteger

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

ratiobodystring

Output aspect ratio. Defaults to 16:9.

Available values: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9

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.