About MiniMax H3 Image LoRA
MiniMax H3 Image LoRA uses the open-weights MiniMax H3 video generator to make single stills, with up to three of your own LoRA files loaded per request. Text-to-image and reference editing with up to nine sources, at about one or four megapixels in fifteen aspect ratios. The same LoRAs you use for H3 video work here, and nothing is filtered.
Call it with the model name minimax/h3-image-lora/text-to-image on POST /jobs/createTask, from 7 credits per image ($0.07). New accounts get 30 free credits to try it in the Playground first.
Introduction
MiniMax H3 Image LoRA Text to image makes one still from a written prompt using the open-weights MiniMax H3 video generator, with up to three of your own LoRA files loaded. Choose 1k, about one megapixel, or 2k, about four, in any of fifteen aspect ratios, and get back JPEG, PNG or WebP.
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
A video model's frame, as a still
This endpoint runs the same generator as the H3 video families and returns a single frame. The result reads like a film still: directional light, shallow depth of field and natural skin rather than a glossy render.
The same LoRAs as your H3 videos
Because it is the same model, character and style LoRAs trained for MiniMax H3 apply here unchanged, up to three per request with their own strengths. A VHS style LoRA we use on video produced the same tape look on a still.
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 · Default: 1:1 |
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 | Describe the subject, composition and lighting. |
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 | 6.3 | $0.063 |
| resolution 2K | 13.5 | $0.14 |
Each task is rounded up to whole credits, so one run at the lowest tier costs 7 credits per image ($0.07).
For an exact number before you run, send the same body to POST /jobs/quote.
Use cases
Opening frames for video
Design the first frame of a clip here with your character LoRA, then send it to MiniMax H3 LoRA image-to-video. The still and the motion share one model, so the look does not jump between them.
Style sheets for a character
Keep a character LoRA and seed fixed and change only the outfit, place and light between prompts to build a consistent set of stills.
Prompt guide & pro tips
Light it like a film shot
Name the light source, its direction and its colour, then the lens feel: a warm lamp from the left, blue window light behind, shallow depth of field. H3 was trained on video, and lighting language lands better than style adjectives.
Trigger first, then the picture
Most community LoRAs expect their trigger word at the start of the prompt. After it, describe the subject and the setting and let the weights carry the style.
Draft at 1k, finish at 2k
1k images come back in seconds. When a draw is right, keep the seed and re-run at 2k for the final. Change one LoRA scale at a time when you compare.
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/text-to-image 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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"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 7 credits ($0.07) per image with Create Image, its cheapest task. Prices by option: 1K 6.3 credits per image, 2K 13.5 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; Prompt length (characters): 5,000. 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
