curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "h3-max-turbo",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1790245800-h3turbo1",
"status": "not_started",
"created_time": "2026-09-24T10:30:00Z"
}
}Hailuo
H3 Max Turbo
Generate videos from text, a first frame, or first and last frames
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "h3-max-turbo",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1790245800-h3turbo1",
"status": "not_started",
"created_time": "2026-09-24T10:30:00Z"
}
}H3 Max Turbo generates 5–15 second videos at 480p, 768p, or 1080p. Submit a task with
model: "h3-max-turbo", then poll its status or provide a callback_url to receive the result.
Generation Modes
- Text to video: omit
image_urlsor pass an empty array. - First frame: provide one image in
image_urls. - First and last frames: provide two images in
image_urls, with the starting frame first and the ending frame second.
aspect_ratio whenever image_urls contains images.
Parameter Notes
promptis required in every mode and accepts up to 50,000 characters.durationaccepts an integer from5through15seconds and defaults to5.resolutionaccepts480p,768p, or1080pand defaults to768p. UppercasePis also accepted.enable_safety_checker(boolean) enables the safety checker whentrue. Defaults totruein every mode; setfalseto disable it.- Text-to-video supports
21:9,16:9,4:3,1:1,3:4, and9:16. Its default aspect ratio is16:9. image_urlsaccepts at most two publicly accessible image URLs or Base64 images.- Reference media, custom audio tracks, seed, and prompt-expansion controls are not available for this model.
Billing
Video generation is billed by output duration and resolution.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json