Skip to content

H3 Max Lip Sync Image to Video

Integrate

Model id minimax/h3-max/lip-sync/image-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/minimax/h3-max/lip-sync/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.80 800 API credits your files are measured before the run Run it on this page

Get API key
MiniMax · Video

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required image_url
Drop a file, or

Animation input image; only aspect ratios within the 0.4–2.5 range are accepted.

•required audio_url
Drop a file, or

Audio driving the mouth movements, with a supported duration of 5 seconds to 15 minutes. The generated video has the same duration as the audio.

resolution default 768P

Resolution of the generated output, using the supported aspect ratio closest to that of the image.

Advanced seed · enable_transcription · enable_safety_checker

Seed for random generation; omission causes a random selection.

POST /run/minimax/h3-max/lip-sync/image-to-video?wait=20 quote → $0.80
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/minimax/h3-max/lip-sync/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About H3 Max Lip Sync Image to Video

Animates a single image so the mouth movements follow a supplied audio clip. The audio must be at least 5 seconds long, supports up to 15 minutes, and the output length matches it. Image aspect ratio must be between 0.4 and 2.5. `resolution` goes from 480P to 2K, and `enable_transcription` can add a transcript to guide synchronization.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
Animation input image; only aspect ratios within the 0.4–2.5 range are accepted.
audio_urlrequired audio
Typeurl · audio
Audio driving the mouth movements, with a supported duration of 5 seconds to 15 minutes. The generated video has the same duration as the audio.
resolutionoptional
Typeenum
Default768P
480P768P1080P2K
Resolution of the generated output, using the supported aspect ratio closest to that of the image.
enable_transcriptionoptional
Typeboolean
Defaultfalse
Transcript assistance for lip synchronization. With this disabled, synchronization uses audio alone; enabling it transcribes the supplied audio and uses that transcript as guidance.
seedoptional
Typeinteger | null
0 – 2,147,483,647
Seed for random generation; omission causes a random selection.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Controls whether content safety screening is enabled.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/h3-max/lip-sync/image-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 800,
    "usd": "0.80",
    "charged": 800,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/avatar/talking_avatar.jpg",
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "duration": 5,
    "timings": {}
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
video
object {url, content_type, file_name, file_size}Video with synchronized lip movements and the provided audio track.
seed
integerRandom generator seed used to produce the result.
duration
numberDuration of the result, measured in seconds.
timings
object | nullTiming measurements expressed in seconds, available only on routes reporting backend timings; otherwise null. The 'inference' entry aggregates GPU-backend DiT denoising time across all windows generated for this request.

More models: Lipsync & Avatars

For AI agents: this page as Markdown is at https://doitong.com/developers/models/minimax/h3-max/lip-sync/image-to-video.md. All models and guides: https://doitong.com/developers/llms.txt