---
title: "OmniHuman 1.5 - Create human animation"
method: POST
path: "/v1/ai/video/omni-human-1-5"
tags: ["video"]
---

# OmniHuman 1.5 - Create human animation

`POST /v1/ai/video/omni-human-1-5`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/video/omni-human-1-5`
- Auth: API key in header `x-magnific-api-key`

Generate animated video of a human figure driven by audio using OmniHuman 1.5 model (ByteDance). Supports natural head movements, facial expressions, and body motion synchronized to audio input.

## Request body

- OmniHuman15Request
  - `webhook_url` string, uri: Webhook URL to notify the user when the task is completed
  - `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.
  - `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.
  - `prompt` string: Optional text guidance for the generation. Can describe desired motion, expression, or style.
  - `turbo_mode` boolean: Enable faster generation with potentially reduced quality
  - `resolution` '720p' | '1080p': Video resolution. 1080p allows max 30 seconds audio, 720p allows max 60 seconds audio.

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)