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"
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}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.
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"
}
'{
"id": "9552de3d-171f-4cca-b492-7baa56523239",
"status": "pending",
"polling_url": "https://api.tikway.ai/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
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.
HappyHorse model ID.
happyhorse-1.1, happyhorse-1.0 Video generation or editing prompt words.
1Output duration is 3–15 seconds. Video editors ignore this field and inherit the input video duration.
3 <= x <= 15Video aspect ratio. When producing videos, some models will automatically determine the proportions based on the input material.
16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 21:9, 9:21 Output resolution. Available values for different models or modes are shown in the model capabilities table.
480p, 720p, 1080p Only one first frame image is supported, and the last frame or first and last frame interpolation is not supported.
1Reference student videos only accept 1–9 reference_images. happyhorse-1.0 video editor accepts 1 source_video and up to 5 reference_images.
9- Option 1
- Option 2
Hide child attributes
Hide child attributes
Image URL string.
1Optional. Material type; if provided, must be consistent with the corresponding URL field.
image_url, video_url Material usage. When omitted, normal reference material is inferred from the URL field.
reference_image, source_video Video URL string.
1Random seed. Fixed seeds can only improve reproducibility, but do not guarantee that the output will be completely consistent.
-1 <= x <= 2147483647User task callback address. Called by Tikway after the task status changes, it is not directly passed to the model upstream.
^https://Response
POST /v1/videos Response parameters after the video task is successfully created. The interface returns HTTP 202.
The unique identifier of the video generation task, used for subsequent query of task status.
1"9552de3d-171f-4cca-b492-7baa56523239"
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.
pending, queue "queue"
Video task query address, the client can poll the task status through GET request.
^https://"https://api.example.com/v1/videos/9552de3d-171f-4cca-b492-7baa56523239"