MiniMax H3 Max Recast overview
MiniMax H3 Max Recast by MiniMax
MiniMax H3 Max Recast is a MiniMax video to video model. It recasts a source clip with new people and leaves the original motion, camera work, cuts and sound as they were.
MiniMax H3 Max Recast specs
- Model ID
minimax/h3-max-recast- Developer
- MiniMax
- Input
- Video
- Output
- Video
- Endpoint
POST https://api.aimlapi.com/v2/video/generations
What stays and what changes
Only the main people in the source clip are replaced. Everything else in the shot comes from your original video, so the quality of the result depends on how clearly the source shows its subjects.
The reference photos define the new appearance. Use clear photos of each person you want to appear, and supply as many as there are main people to replace.
Settings that shape the result
Resolution sets the short side of the output in pixels, with 768p and 1080p available. Start with 768p while you check that the swap lands on the right people, then render the final version at 1080p.
Enhance realism, when set to true, gives more natural skin textures and better blending of the new people into the scene. Turn it on for close-ups and clips where faces fill much of the frame. Compare one render with it on and one with it off before you fix the setting.
Check before you scale
Review a short test clip frame by frame around cuts and fast movement. Confirm that each reference person maps to the intended person in the source and that the sound still matches the action.
Use cases
Recast a product demo clip with a different presenter taken from reference photos.
Swap the actors in a short scene to produce regional versions of the same ad.
Replace the people in a 30 second social video with 1-4 new faces while keeping the original soundtrack.
Test several casting options on one edited video without reshooting.
MiniMax H3 Max Recast API pricing
| Usage | Price | Unit |
|---|---|---|
| Video generation | $0.234 |
Prices from the AI/ML API price list, checked on Nov 13, 2026.
How to use the MiniMax H3 Max Recast API
View docs
Build with your agent
Give your agent the model details, code and documentation.
1Get your API key
Create API keyexport AIMLAPI_KEY="8f2b4c7d9a1e6b3f…"2Make your first request
curl 'https://api.aimlapi.com/v2/video/generations' \
-H "Authorization: Bearer $AIMLAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "minimax/h3-max-recast",
"video_url": "https://example.com/input.mp3",
"reference_image_urls": [
"https://example.com/input.jpg"
]
}'import os
import requests
headers = {
"Authorization": f"Bearer {os.environ['AIMLAPI_KEY']}",
"Content-Type": "application/json",
}
payload = {
"model": "minimax/h3-max-recast",
"video_url": "https://example.com/input.mp3",
"reference_image_urls": [
"https://example.com/input.jpg"
]
}
response = requests.post("https://api.aimlapi.com/v2/video/generations", headers=headers, json=payload, timeout=120)
response.raise_for_status()
print(response.json())const response = await fetch("https://api.aimlapi.com/v2/video/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "minimax/h3-max-recast",
"video_url": "https://example.com/input.mp3",
"reference_image_urls": [
"https://example.com/input.jpg"
]
}),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());The request returns a generation id. Poll GET https://api.aimlapi.com/v2/video/generations?generation_id=<id> until the status is completed.
Models similar to MiniMax H3 Max Recast
MiniMax H3 Max Recast FAQ
How much does MiniMax H3 Max Recast cost?
MiniMax H3 Max Recast costs $0.2335 / sec on AI/ML API.
How long can the source video be?
The source video can run from 5 to 30 seconds.
How many reference photos can I use?
You can supply 1 to 4 reference photos. They provide the people who replace the main people in the video.
What is preserved from the original video?
MiniMax H3 Max Recast keeps the original motion, camera, cuts and sound. Only the main people are replaced.
What does enhance realism do?
It gives more natural skin textures and better blending of the new people into the scene. You can set it to true or false.
What is the MiniMax H3 Max Recast model ID?
Use minimax/h3-max-recast as the model parameter. Requests go to https://api.aimlapi.com/v2/video/generations with your AI/ML API key.