Skip to content
Docs menu

Video models

OmniHuman 1.5

On this page

OmniHuman 1.5 — high-quality AI video generation.

modelIdomnihuman-1-5
Modalityvideo
PricingSee this model on the Pricing page for the current per-call price (with your markup).

Operations

OperationmodelIdEndpointRequired input
Defaultomnihuman-1-5POST /api/v1/generateimage_url, audio_url
Poll taskGET /api/v1/task/{id}?model=omnihuman-1-5

Input parameters

FieldTypeRequiredValues / example
image_urlstringYesPortrait image URL, supports any aspect ratio with subjects including people/pets/anime, etc. (image URL)
mask_urlstringNoOptional. One or more mask image URLs, to pick which subject in the image speaks. Leave empty to let the model choose.
audio_urlstringYesAudio URL. Duration must be < 60 seconds (recommended ≤15 seconds; exceeding this will cause degradation). (image URL)
promptstringNoPrompt text, limited to Chinese/English/Japanese/Korean/Spanish/Indonesian, recommended ≤300 characters. Max 1000 characters. (default: Make the person in the photo speak the audio naturally with warm, friendly gestures.)
output_resolutionstringNoOutput video resolution, default 1080. (options: 720 | 1080) (default: 1080)
pe_fast_modebooleanNoFast mode, sacrifices some quality to speed up generation. (true/false) (default: false)
seednumberNoRandom seed. Default is -1 (random). When using the same positive integer and keeping all other parameters identical, the result will be highly consistent (with very high probability). (default: -1)

Example request

bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"omnihuman-1-5","input":{"image_url":"https://example.com/input.jpg","mask_url":"example","audio_url":"https://example.com/input.mp3","prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","output_resolution":"1080","pe_fast_mode":false,"seed":-1}}'