Skip to main content
POST
/
v1
/
ai
/
video
/
omni-human-1-5
OmniHuman 1.5 - Create human animation
curl --request POST \
  --url https://api.freepik.com/v1/ai/video/omni-human-1-5 \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "image_url": "https://example.com/human-figure.jpg",
  "audio_url": "https://example.com/audio.mp3",
  "webhook_url": "<string>",
  "prompt": "A person speaking naturally with subtle head movements",
  "turbo_mode": false,
  "resolution": "1080p"
}
'
{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Body

application/json
​
image_url
string<uri>
required

URL of the human figure image to animate. Image must be publicly accessible, contain a visible human figure, and be in jpg, jpeg, png, or webp format.

Example:

"https://example.com/human-figure.jpg"

​
audio_url
string<uri>
required

URL of the audio file that drives the animation. Must be publicly accessible. Supported formats: MP3, OGG, WAV, M4A, AAC. Duration limits: 720p max 60 seconds, 1080p max 30 seconds.

Example:

"https://example.com/audio.mp3"

​
webhook_url
string<uri>

Webhook URL to notify the user when the task is completed

​
prompt
string

Optional text guidance for the generation. Can describe desired motion, expression, or style.

Maximum string length: 2000
Example:

"A person speaking naturally with subtle head movements"

​
turbo_mode
boolean
default:false

Enable faster generation with potentially reduced quality

​
resolution
enum<string>
default:1080p

Video resolution. 1080p allows max 30 seconds audio, 720p allows max 60 seconds audio.

Available options:
720p,
1080p

Response

OK - The task exists and the status is returned

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}