Introduction
MiniMax H3 Image LoRA Image editing re-renders the people and things in your reference images into a new scene, outfit, pose or style, using the open-weights MiniMax H3 with up to three of your own LoRA files. Send one to nine images, refer to them as Picture 1, Picture 2 and so on, and get one image at 1k or 2k in the first reference's shape or any of fifteen aspect ratios.
Choose a mode by starting material
| What you have | Mode |
|---|---|
| a written description | MiniMax H3 Image LoRA Text to image |
| one to nine images to change | MiniMax H3 Image LoRA Edit |
| a still you want to animate | MiniMax H3 LoRA Image to video |
Key features
Identity carried over from the references
Faces, hairstyles and distinctive clothing details carry over while everything else changes. In our test a single portrait went into a completely different setting and pose, and the face and hair stayed recognisably the same person.
Up to nine numbered sources
Combine a person, an outfit, an object and a place from separate images in one request. Numbering them in the prompt tells the model which picture does which job.
Request parameters
| Parameter | Required | Description |
|---|---|---|
aspect_ratio | No | The shape of the frame: wide, square or tall. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 |
image_urls | Yes | Photos to edit or combine. Say in the prompt what each one adds. |
loras | No | Load your own LoRA files to lock in a style or character. Default: [] |
output_format | No | File type of the result. jpeg · png · webp · Default: jpeg |
prompt | Yes | Say what to change. Refer to the references as <Picture 1>, <Picture 2> and so on. |
resolution | No | Output size. Bigger sizes look sharper and cost more. 1k · 2k · Default: 1k |
seed | No | Reuse the same number to get a repeatable result. ≥ 0 · ≤ 2147483647 |
Pricing
Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.
| Option | Credits per image | ≈ USD |
|---|---|---|
| resolution 1K | 8.1 | $0.081 |
| resolution 2K | 18.9 | $0.19 |
Each task is rounded up to whole credits, so one run at the lowest tier costs 9 credits per image ($0.09).
For an exact number before you run, send the same body to POST /jobs/quote.
Use cases
New scenes for the same person
One clean portrait is enough to place someone on a balcony, in a hotel room or on a stage. Change the light and the clothes in the prompt and keep the face from the picture.
Wardrobe and product swaps
Send the person as Picture 1 and a garment or product as Picture 2, and ask for the person wearing or holding it. Useful for catalogues and for keeping a character's outfit consistent.
Restyle with a LoRA
Load an anime, film-stock or VHS LoRA and ask for the same image in that style. The composition and the person stay; the medium changes.
Prompt guide & pro tips
Map the pictures, then describe the change
Start with one short sentence per reference, then describe only what should be different. Describing the face again tends to fight the reference rather than help it.
Fewer, clearer references
Crop references so the part you care about fills the frame.
API quick start
Call the MiniMax H3 Image LoRA API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
- Send the request. POST /jobs/createTask with model minimax/h3-image-lora/edit and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-image-lora/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"resolution": "1k",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
MiniMax H3 Image LoRA API questions
How much does the MiniMax H3 Image LoRA API cost?
MiniMax H3 Image LoRA starts at 9 credits ($0.09) per image with Edit Image, its cheapest task. Prices by option: 1K 8.1 credits per image, 2K 18.9 credits per image. Credits are the same as on the website (1 credit = $0.01), new accounts get 30 free credits, and failed tasks are refunded.
What is the model name for MiniMax H3 Image LoRA in the API?
Put minimax/h3-image-lora/text-to-image for Create Image; minimax/h3-image-lora/edit for Edit Image in the model field of POST /jobs/createTask.
Is this a separate image model?
No. It is MiniMax H3, the video model, generating a single frame. That is why its stills look like film frames and why your H3 video LoRAs work here.
How do I supply a LoRA?
As an entry in the loras array: a direct HTTPS link to a .safetensors file trained for MiniMax H3, and a scale from 0 to 4.
How big are the images?
1k is about one megapixel (a 3:2 image came back at 1248 x 832 in our test), 2k about four megapixels.
Does editing keep the person's face?
Yes, that is what it is built for. In our test the output kept the reference's face and hairstyle while the pose, clothes and setting changed.
Can I get transparent PNGs?
No. PNG is returned as a regular three-channel image.
What are the limits of the MiniMax H3 Image LoRA API?
Resolutions: 1K · 2K; Aspect ratios: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Reference images: 9; Prompt length (characters): 5,000; Largest upload: 10 MB. Requests outside these limits are rejected before anything is charged.
Can I try MiniMax H3 Image LoRA without writing code?
Yes. The Playground runs MiniMax H3 Image LoRA on your PopNow credits, needs no API key, and shows the matching code for every run.
All MiniMax models
For moving pictures with the same weights, use MiniMax H3 LoRA.
- MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
- MiniMax Speech 2.8 HD APIHigh-fidelity speech in 400+ voices with emotion controlFrom 18 credits per 1,000 characters
- MiniMax Music 3.0 APIFinished stereo songs, with vocals or instrumentalFrom 27 credits per run
- MiniMax H3 Singularity LoRA APICommunity-tuned H3 video that loads your own LoRAsFrom 45 credits for a 5-second clip
- MiniMax H3 Max APIFast clips with ambience, effects and musicFrom 38 credits for a 5-second clip
- MiniMax H3 LoRA APIMiniMax H3 video with sound and up to three of your LoRAsFrom 38 credits for a 5-second clip
- MiniMax H3 Image LoRA APIH3 stills and edits with up to three of your LoRAsFrom 7 credits per image
- MiniMax Speech 2.8 Turbo APIFast speech in 400+ voices with emotion controlFrom 11 credits per 1,000 characters


