Skip to main content
POST
OmniHuman 1.5 - Create human animation

Authorizations

x-magnific-api-key
string
header
required

Your Magnific 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: