Skip to content
youbot
Docs menu
APIFile UploadAccount & Common

Video models

Hailuo 02

On this page

Hailuo 02 — high-quality AI video generation.

modelIdhailuo-02-text-to-video-pro, hailuo-02-image-to-video-pro, hailuo-02-text-to-video-standard, hailuo-02-image-to-video-standard
Modalityvideo
PricingSee this model on the Pricing page for the current per-call price (with your markup).

Operations

OperationmodelIdEndpointRequired input
Text To Video Prohailuo-02-text-to-video-proPOST /api/v1/generateprompt
Image To Video Prohailuo-02-image-to-video-proPOST /api/v1/generateprompt, image_url
Text To Video Standardhailuo-02-text-to-video-standardPOST /api/v1/generateprompt
Image To Video Standardhailuo-02-image-to-video-standardPOST /api/v1/generateprompt, image_url
Poll task—GET /api/v1/task/{id}?model=hailuo-02-text-to-video-pro—

Text To Video Pro — hailuo-02-text-to-video-pro

FieldTypeRequiredValues / example
promptstringYesThe text prompt for video generation Max 1500 characters. (default: Aerial shot diving through clouds toward a lighthouse on a cliff at the edge of a storm, dramatic shifting light.)
prompt_optimizerbooleanNoWhether to use the model's prompt optimizer (true/false) (default: true)
nsfw_checkerbooleanNoA configurable parameter. Defaults to true in the Playground. (true/false) (default: true)
bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"hailuo-02-text-to-video-pro","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","prompt_optimizer":true,"nsfw_checker":true}}'

Image To Video Pro — hailuo-02-image-to-video-pro

FieldTypeRequiredValues / example
promptstringYesText prompt describing the desired video animation Max 1500 characters. (default: Animate the scene: the hummingbird's wings blur into a rapid hover while the blossom sways softly, a delicate push-in as a dewdrop trembles and slides down a petal.)
image_urlstringYesInput image to animate (image URL)
end_image_urlstringNoOptional URL of the image to use as the last frame of the video (image URL)
prompt_optimizerbooleanNoWhether to use the model's prompt optimizer (true/false) (default: true)
nsfw_checkerbooleanNoA configurable parameter. Defaults to true in the Playground. (true/false) (default: true)
bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"hailuo-02-image-to-video-pro","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","image_url":"https://example.com/input.jpg","end_image_url":"https://example.com/input.jpg","prompt_optimizer":true,"nsfw_checker":true}}'

Text To Video Standard — hailuo-02-text-to-video-standard

FieldTypeRequiredValues / example
promptstringYesText description for video generation Max 1500 characters. (default: A low aerial glides just above towering ocean swells during a gathering storm, spray tearing off the whitecaps in slow motion as steel-grey light knifes through the heavy clouds overhead.)
durationstringNoThe duration of the video in seconds. 10 seconds videos are not supported for 1080p resolution. (options: 6 | 10) (default: 6)
prompt_optimizerbooleanNoWhether to use the model's prompt optimizer (true/false) (default: true)
nsfw_checkerbooleanNoA configurable parameter. Defaults to true in the Playground. (true/false) (default: true)
bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"hailuo-02-text-to-video-standard","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","duration":"6","prompt_optimizer":true,"nsfw_checker":true}}'

Image To Video Standard — hailuo-02-image-to-video-standard

FieldTypeRequiredValues / example
promptstringYesThe text prompt describing the video to generate Max 1500 characters. (default: Animate the frame with a gentle parallax drift across a rooftop garden at blue hour, string lights swaying in the breeze as distant skyscraper windows flicker on one by one.)
image_urlstringYesThe URL of the image to use as the first frame of the video (image URL)
end_image_urlstringNoOptional URL of the image to use as the last frame of the video (image URL)
durationstringNoThe duration of the video in seconds. 10 seconds videos are not supported for 1080p resolution. (options: 6 | 10) (default: 10)
resolutionstringNoThe resolution of the generated video. (options: 512P | 768P) (default: 768P)
prompt_optimizerbooleanNoWhether to use the model's prompt optimizer (true/false) (default: true)
nsfw_checkerbooleanNoA configurable parameter. Defaults to true in the Playground. (true/false) (default: true)
bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"hailuo-02-image-to-video-standard","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","image_url":"https://example.com/input.jpg","end_image_url":"https://example.com/input.jpg","duration":"10","resolution":"768P","prompt_optimizer":true,"nsfw_checker":true}}'
FLUX.2Kling V2.1