by MiniMax

Open-weights H3 images in five sizes up to 4K, with a seed for repeatable tweaks

minimax/h3-image-open/text-to-image
  • Up to 4K
  • Up to 9 reference images
  • 15 aspect ratios
  • Create Image
  • Edit Image

About MiniMax H3-Image Open Weights

Open-weights H3 images in five sizes up to 4K, with a seed for repeatable tweaks.

Call it with the model name minimax/h3-image-open/text-to-image on POST /jobs/createTask, from $0.024.

Introduction

The open-weight H3-Image generator accepts prose and returns a still, using JPEG unless another format is selected.

Key features

Five tiers include 1.5k and 3k between the familiar 1k, 2k and 4k choices. In our tests 1k model time ranged around 20–45 seconds, excluding queueing and transfer.

Request parameters

ParameterRequiredDescription
seedNoUse the same seed and settings for more controlled comparisons. ≥ 0 · ≤ 2147483647
promptYesDescribe what you want to make.
resolutionNoChoose an available output size. 1k · 1.5k · 2k · 3k · 4k · Default: 1k
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 · Default: 1:1
output_formatNoFile type of the result. jpeg · png · webp · Default: jpeg

Pricing

Prices are in USD and charged to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

OptionUSD per image
resolution 1K$0.024
resolution 1.5K$0.036
resolution 2K$0.048
resolution 3K$0.096
resolution 4K$0.144

Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.

Use cases

Explore food photographs or rainy streets using a fixed random source while changing one element of the description.

Prompt guide & pro tips

Set seed before comparing prompt variations; hold other settings steady and revise one detail. An unchanged seed does not establish pixel-for-pixel repeatability.

API quick start

Call the MiniMax H3-Image Open Weights 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-. API calls are billed in USD from your PopNow balance.
  2. Send the request. POST /jobs/createTask with model minimax/h3-image-open/text-to-image 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-open/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 Open Weights API questions

How much does the MiniMax H3-Image Open Weights API cost?

MiniMax H3-Image Open Weights starts at $0.024 per image with Create Image, its lowest-priced task. Prices by option: 1K $0.024 per image, 1.5K $0.036 per image, 2K $0.048 per image, 3K $0.096 per image. API usage is charged in USD to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

What is the model name for MiniMax H3-Image Open Weights in the API?

Put minimax/h3-image-open/text-to-image for Create Image; minimax/h3-image-open/edit for Edit Image in the model field of POST /jobs/createTask.

What does the open-weight option expose?

It provides the MiniMax H3-Image checkpoint with five resolution choices and seed control. The [MiniMax-hosted version](/models/minimax-h3-image) instead offers three sizes and up to sixteen input pictures; output equivalence has not been verified.

Will reusing a seed duplicate my picture?

No exact duplicate is promised. Keeping the same seed holds the random source for a comparison in which you modify one instruction or setting.

Which picture does the editor change?

The first image_urls entry is the editable source. Use <Picture 1> for it and <Picture 2> onward for added references; without an aspect_ratio, output follows the first image.

How do I attach style weights to this checkpoint?

Select [MiniMax H3-Image Open Weights LoRA](/models/minimax-h3-image-open-lora) to supply up to three LoRA files alongside the same five-tier controls.

Is this the older H3 still-frame family or P-H3-Image?

Neither is interchangeable with this option. [MiniMax H3 Image LoRA](/models/minimax-h3-image-lora) uses the H3 video model for single frames; [P-H3-Image](/models/p-h3-image) is a different model that produced different images in our matched-input tests.

What are the limits of the MiniMax H3-Image Open Weights API?

Resolutions: 1K · 1.5K · 2K · 3K · 4K; 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 Open Weights without writing code?

Run MiniMax H3-Image Open Weights in the Playground with your API USD balance, without an API key. Each run appears in your developer history with its matching code.

All MiniMax models

More about MiniMax H3-Image Open Weights