MiniMax H3 Character Replace Pro API

Send a person photo and a guide video with model: minimax-h3-remake to POST /api/v1/videos/generations. The main person takes on the face, hair, body and outfit from the photo, and everything else stays closer to the original than in the standard version: other people keep their exact clothing colors, objects such as a ball keep their color, outfits stay consistent across cuts, and close-ups stay clean. Output is 720p with the original audio.
Get API Key
Film editing desk with several monitors showing the same scene from different camera angles

Replace One Person, Keep Everything Else

Other people stay exactly as they were

In group shots and sports clips, the people you are not replacing keep their exact clothing colors, and objects such as a ball keep their color. Use swap_target to say which person to replace.
Basketball players on a court, each in clearly different colored jerseys

Consistent across shots and cuts

For multi-shot clips, the replaced person's outfit stays the same from one shot to the next, and cuts to close-ups stay clean.
Storyboard panels pinned to a wall showing one character in wide and close-up framings

Same API, 20% more per second

Parameters match minimax-h3-swap, so switching is a one-word change to model; the price is 2.4 tokens ($0.048) per second, 20% above the standard version. Outputs of about 13.7 seconds or less use the Pro model; 14 to 15 second outputs are generated with the standard Character Replace model.
Two identical mechanical keys on a desk, one with a subtle gold accent
image_url and video_url are required; the rest refine which person changes and how much of the video is used.

MiniMax H3 Character Replace Pro Request Fields and Limits

image_url (required)

Public URL of the person photo, up to 10 MB. This person replaces the main person in the video.

video_url (required)

Public URL of the guide video, up to 100 MB, at least 5 seconds. Videos longer than 15 seconds are rejected unless duration is set.

duration

Optional integer from 5 to 15. Renders only the first N seconds and must not exceed the actual video length; a longer value is rejected, not clamped.

resolution

480p or 720p (default 720p). The video is always generated at 720p at the same price; aspect ratio follows the guide video.

swap_target

Optional, up to 600 characters. Which person to replace when there are several, described by position or action.

swap_details and callback

swap_details: optional head-to-toe description of the photo's person, up to 800 characters. custom_callback_url: optional public HTTPS URL for status updates.
One rate for every request, billed per second of the generated video.

MiniMax H3 Character Replace Pro API Pricing

2.4 tokens ($0.048) per second

All output is 720p, so there is a single rate. A 5-second result costs 12 tokens ($0.24).

Billed on output length

Without duration, a 14.6-second guide video produces 14 seconds and costs 33.6 tokens ($0.672).

Cap the bill with duration

The longest output, 15 seconds, costs 36 tokens ($0.72). Use duration to render a shorter opening section of a long clip.

Refunds on failure

Tokens are deducted when the task is accepted and returned automatically if the generation fails. cost in the response is the amount actually charged.

Integrate the MiniMax H3 Character Replace Pro API

1

1. Create an API key

Generate it at /keys and call the API from your server with Authorization: Bearer <key>.
2

2. Prepare the inputs

Host a front-facing photo of one person and a guide video of at least 5 seconds. Trim or set duration for anything longer than 15 seconds.
3

3. Submit

POST {"model": "minimax-h3-remake", "image_url": "…", "video_url": "…"} to /api/v1/videos/generations, adding swap_target for multi-person shots. Store img_uuid.
4

4. Fetch the result

Poll GET /api/v1/jobs/detail or use custom_callback_url; download the video before link_expired_at.
Create an API Key
Character replacement for footage where the surroundings matter.

What Developers Build with MiniMax H3 Character Replace Pro

Sports and team moments

Put a user into a match highlight while teammates, opponents and the ball keep their real colors.

Multi-shot music and dance clips

Re-cast performers in clips that cut between wide shots and close-ups without the outfit changing between shots.

Ad variants with different talent

Swap the presenter in an approved multi-shot ad while the set, extras and soundtrack stay as shot.

Upgrade path from Character Replace

Offer a higher-fidelity option in an existing integration by changing only the model value, for 20% more per second.
Differences from the standard version, inputs, length and billing.

MiniMax H3 Character Replace Pro API FAQ

How is it different from MiniMax H3 Character Replace?

Same inputs; the price is 20% higher. The Pro version keeps other people's clothing colors and object colors, keeps outfits consistent across shots and cuts, and keeps close-ups clean. In our tests a render takes about 1 to 1.5 times as long.

What is kept from the original video?

The scene, camera motion, movement and audio track. Logos, watermarks and on-screen text are also kept.

What output resolution do I get?

Always 720p. 480p is accepted as a value but still renders at 720p for the same price.

How long can the guide video be?

At least 5 seconds. Over 15 seconds is rejected unless you set duration (5 to 15) to use only the first N seconds.

What happens with 14 to 15 second outputs?

Outputs of about 13.7 seconds or less use the Pro model. Longer outputs are generated with the standard Character Replace model and are still billed at the Pro rate.

How do I choose who gets replaced in a group shot?

Set swap_target to a position or action, for example "the person in the center of the frame".

How much does it cost?

2.4 tokens ($0.048) per second of output: 12 tokens ($0.24) for 5 seconds, up to 36 tokens ($0.72) for 15 seconds.

What photo works best?

A clear, front-facing half-body or full-body photo of a single person.

Start Building with the MiniMax H3 Character Replace Pro API

MiniMax H3 Character Replace Pro API: Pricing | GoEnhance