Create a HappyHorse video

Create HappyHorse video tasks via unified POST /v1/videos. Model capabilities are subject to the actual callable range of the current Tikway gateway.

Model	Resolution	Duration	Supported Modes	Audio	Reference Limitations
happyhorse-1.1	480p / 720p / 1080p	3–15 seconds	Vincent, first frame image, 1–9 image reference	Upstream generated audio video; no switch	Does not support last frame, video editing or extension
happyhorse-1.0	480p / 720p / 1080p; editing only 720p / 1080p	3–15 seconds; editing follows input video	Vincent, first frame image reference, 1–9 image reference, video editing	None generate_audio; editing available audio_setting	Does not support last frame or video extension

Source: Alibaba Cloud Video Generation and Editing Model. The difference between the official website capabilities and the current unopened capabilities of the gateway can be found in this audit report.

POST https://api.tikway.ai/v1/videos

cURL

Text to video

curl --request POST \ --url https://api.tikway.ai/v1/videos \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "happyhorse-1.1", "prompt": "A golden retriever runs on the beach at sunset. The camera follows smoothly, and the picture has a natural and delicate film quality.", "duration": 5, "resolution": "1080p", "aspect_ratio": "16:9" } '

202

{
  "id": "9552de3d-171f-4cca-b492-7baa56523239",
  "status": "pending",
  "polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a HappyHorse video task. Parameters are narrowed according to the current Tikway gateway capabilities; for differences between models, see operation description and x-model-capabilities.

model · enum<string> · required

HappyHorse model ID.

Available options: happyhorse-1.1, happyhorse-1.0

prompt · string

Video generation or editing prompt words.

Minimum string length: 1

duration · integer

Output duration is 3–15 seconds. Video editors ignore this field and inherit the input video duration.

Required range: 3 <= x <= 15

aspect_ratio · enum<string>

Video aspect ratio. When producing videos, some models will automatically determine the proportions based on the input material.

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

resolution · enum<string>

Output resolution. Available values ​​for different models or modes are shown in the model capabilities table.

Available options: 480p, 720p, 1080p

frame_images · object[]

Only one first frame image is supported, and the last frame or first and last frame interpolation is not supported.

Maximum array length: 1

Hide child attributes

frame_images. type · enum<string> · required

Reference frame position.

Available options: first_frame

frame_images. image_url · string<uri> · required

Reference image URL string.

Minimum string length: 1

input_references · object[]

Reference student videos only accept 1–9 reference_images. happyhorse-1.0 video editor accepts 1 source_video and up to 5 reference_images.

Maximum array length: 9

Option 1

Option 2

Hide child attributes

input_references. image_url · string<uri> · required

Image URL string.

Minimum string length: 1

input_references. type · enum<string>

Optional. Material type; if provided, must be consistent with the corresponding URL field.

Available options: image_url, video_url

input_references. role · enum<string>

Material usage. When omitted, normal reference material is inferred from the URL field.

Available options: reference_image, source_video

input_references. video_url · string<uri>

Video URL string.

Minimum string length: 1

seed · integer

Random seed. Fixed seeds can only improve reproducibility, but do not guarantee that the output will be completely consistent.

Required range: -1 <= x <= 2147483647

callback_url · string<uri>

User task callback address. Called by Tikway after the task status changes, it is not directly passed to the model upstream.

Pattern: ^https://

extra_body · object

HappyHorse upstream extension parameters.

Hide child attributes

extra_body. watermark · boolean

Whether to add HappyHorse watermark.

extra_body. audio_setting · enum<string>

Video editing only: Automatically process audio or keep original audio.

Available options: auto, origin

Response

202 - application/json

POST /v1/videos Response parameters after the video task is successfully created. The interface returns HTTP 202.

id · string · required

The unique identifier of the video generation task, used for subsequent query of task status.

Minimum string length: 1

Example:

"9552de3d-171f-4cca-b492-7baa56523239"

status · enum<string> · required

Task creation status. pending means that the task has been created and is waiting for submission; queue means that the task has entered the generation queue.

Available options: pending, queue

Example:

"queue"

polling_url · string<uri> · required

Video task query address, the client can poll the task status through GET request.

Pattern: ^https://

Example:

"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"