Omnihuman 1.5

Endpoint

POST /videos/generations

Full URL: https://modelfold.ai/v1/videos/generations

Authentication: every request must include the Authorization: Bearer <API_KEY> header.

Send model parameters directly in the JSON body. Do not wrap them in input. This request waits for generation to finish and returns data[].url; supported media models also offer async jobs, polling and callbacks. Replace example media URLs with your own publicly accessible files. See API gateway for billing and errors.

Input parameters for the audio-driven portrait animation task.

Request Parameters

Body (application/json)

Parameter	Type	Required	Description
model	string	Yes	The model name used for generation. This field is required. - This endpoint must use the omnihuman-1-5 model Default："omnihuman-1-5"。 Allowed values：omnihuman-1-5。 Example：omnihuman-1-5。
image_url	string	Yes	Portrait image URL. Supports any aspect ratio with subjects including people, pets, anime, etc. Accepted file types: image/jpeg, image/png, image/webp. Max file size: 10MB.
mask_url	array<string>	No	Optional mask image URL(s). To have a specific subject in the image speak, use 'Subject Detection' to get the corresponding mask image and pass it as input. Accepted file types: image/jpeg, image/png, image/webp. Max file size: 10MB. Multiple file upload is supported, up to 5 files. maxItems: 5.
audio_url	string	Yes	Audio URL. Duration must be less than 60 seconds (recommended 15 seconds or less; exceeding this will cause quality degradation). Accepted file types: audio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/mp4. Max file size: 10MB.
prompt	string	Yes	Prompt required by the ModelFold gateway; at most 2000 characters. Optional. Supported languages: Chinese, English, Japanese, Korean, Spanish, Indonesian. Up to 300 characters. maxLength: 300.
output_resolution	string	No	Output video resolution. - 720: 720P - 1080: 1080P (default) The output keeps the aspect ratio of the input image; 720 and 1080 are resolution tiers, not exact heights. The output is an MP4 as long as the audio. Default："1080"。 Allowed values：720 / 1080。 Example：1080。
pe_fast_mode	boolean	No	Fast mode. Sacrifices some quality to speed up generation. Default value: false. Default：false。 Example：false。
seed	integer	No	Random seed. Default is -1 (random). When using the same positive integer and keeping all other parameters identical, the result will be highly consistent. Default：-1。 Example：-1。

Request Example

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "omnihuman-1-5",
  "image_url": "https://example.com/reference.png",
  "audio_url": "https://example.com/reference.mp3",
  "prompt": "A paper boat drifting down a rainy street.",
  "output_resolution": "1080",
  "pe_fast_mode": false,
  "seed": -1
}'

{
  "model": "omnihuman-1-5",
  "image_url": "https://example.com/reference.png",
  "audio_url": "https://example.com/reference.mp3",
  "prompt": "A paper boat drifting down a rainy street.",
  "output_resolution": "1080",
  "pe_fast_mode": false,
  "seed": -1
}

Response

200 — Generation completed. usage contains actual billing details; result URLs are illustrative.

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}