minimax/h3-image-lora/editFrom 9 credits per image· Edit Image

MiniMax H3 Image LoRA image editing takes one to nine reference images, a description of the change and up to three of your own LoRAs. Identity carries over into a new scene, outfit, pose or style at about 1 or 4 megapixels.

Call it with the model name minimax/h3-image-lora/edit on POST /jobs/createTask, from 9 credits per image ($0.09). New accounts get 30 free credits to try it in the Playground first.

  • Create Image
  • Edit Image
  • Up to 2K
  • Up to 9 reference images
  • 15 aspect ratios
  • Loads your own LoRA

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 haveMode
a written descriptionMiniMax H3 Image LoRA Text to image
one to nine images to changeMiniMax H3 Image LoRA Edit
a still you want to animateMiniMax 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

ParameterRequiredDescription
aspect_ratioNoThe 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_urlsYesPhotos to edit or combine. Say in the prompt what each one adds.
lorasNoLoad your own LoRA files to lock in a style or character. Default: []
output_formatNoFile type of the result. jpeg · png · webp · Default: jpeg
promptYesSay what to change. Refer to the references as <Picture 1>, <Picture 2> and so on.
resolutionNoOutput size. Bigger sizes look sharper and cost more. 1k · 2k · Default: 1k
seedNoReuse 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.

OptionCredits per image≈ USD
resolution 1K8.1$0.081
resolution 2K18.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

  1. 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.
  2. 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.
  3. 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.

More about MiniMax H3 Image LoRA