minimax-h3-imagedefaultMinimax H3 Image API — how to connect and pay
MiniMax H3 Image — image generation and editing. 1K/2K/4K (up to ~16 MP) or a custom width×height (0.66–20 MP, up to 8192 px per side), 10 aspect ratios plus auto. Editing accepts 1–16 reference images; each reference adds 0.5 credits to the price. Prompt expansion is on by default; PNG or JPEG output; optional seed.
Channel comparison
last 7 days
| Channel | Price |
|---|---|
Pixel minimax-h3-imagedefault | from $0.012 per image |
Build the result you need
minimax-h3-imageWhat is Minimax H3 Image
MiniMax H3 Image — image generation and editing. 1K/2K/4K (up to ~16 MP) or a custom width×height (0.66–20 MP, up to 8192 px per side), 10 aspect ratios plus auto. Editing accepts 1–16 reference images; each reference adds 0.5 credits to the price. Prompt expansion is on by default; PNG or JPEG output; optional seed.
Contract at a glance
- Input
- text, image
- Output
- image
- Mode
- async (job + polling)
- Status polling
- every 3 s · up to 90 s
Strengths
- Pricing: per image
- Inputs: text, image
- 2 configurable options
- One API key for media generation
Where it is used
- Article and social media illustrations
- Product images
- Banners and covers
- Design prototypes
API contract
Generation runs asynchronously: create a job, then poll its status until completion.
- Create job
- POST /api/media/generate
- Check status
- GET /api/media/jobs/{jobId}
- Input
- text, image
- Output
- image
- Polling
- every 3 s · up to 90 s
- Authentication
- Authorization: Bearer sk-pv-…
Example request
Pass your key in the Bearer header. The API returns jobId for polling the status.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"minimax-h3-image","prompt":"a beautiful landscape","opts":{"mode":"text-to-image","aspect_ratio":"auto","resolution":"2K","expand_prompt":true,"output_format":"png"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "minimax-h3-image",
"prompt": "a beautiful landscape",
"opts": {
"mode": "text-to-image",
"aspect_ratio": "auto",
"resolution": "2K",
"expand_prompt": true,
"output_format": "png"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API request parameters
Parameters for requests to Minimax H3 Image via the GetVibe API.
promptreq.image_urlmodeaspect_ratioresolutionwidthheightexpand_promptoutput_formatseedimage_urlsimage_file_idimage_base64input_file_ids| Parameter | Type | Values | Default | Price |
|---|---|---|---|---|
promptreq. | text | text description | required | — |
image_url | URL | Public image URL | — | — |
mode | option selection | Generate (text → image) (default) · Edit (image → image) | Generate (text → image) | Generate (text → image): $0.012, Edit (image → image): $0.015333 |
aspect_ratio | option selection | Auto (default) · 1:1 · 5:4 · 4:3 · 3:2 · 16:9 · 21:9 · 4:5 · 3:4 · 2:3 · 9:16 | Auto | Included in the base price |
resolution | option selection | 1K (~1 MP) · 2K (~4 MP) (default) · 4K (~16 MP) | 2K (~4 MP) | 1K (~1 MP): $0.012, 2K (~4 MP): $0.012, 4K (~16 MP): $0.036667 |
width | text / number | any value | — | Included in the base price |
height | text / number | any value | — | Included in the base price |
expand_prompt | yes/no | Yes (default) · No | Yes | Included in the base price |
output_format | option selection | PNG (default) · JPEG | PNG | Included in the base price |
seed | text / number | any value | — | Included in the base price |
image_urls | Array<URLs>, 0–16 items | Public HTTP(S) URLs | — | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
input_file_ids | Array<strings> | List of values | — | Included in the base price |
Request: POST https://getvibeapi.com/api/media/generate. Prices in USD.
Price of Minimax H3 Image
The cost of Minimax H3 Image: from $0.012 per image. The price is calculated dynamically at the current exchange rate, and the final charge is shown in the API response (priceRub). Payment in USD, no subscriptions.
What a default request costs
With no parameters sent, the request uses these values: Resolution — 2K (~4 MP), Mode — Generate (text → image), Frame format — Auto, Enhance prompt (on by default) — Yes. That request costs $0.012.
Channels and prices for every parameter combination
For every channel, the price of every parameter combination. It is exactly the amount a successful generation is charged, and the same figure as in the machine-readable table linked below.
Pixelminimax-h3-imagefrom $0.012exact prices
| Mode \ Resolution | 1K (~1 MP) | 2K (~4 MP) | 4K (~16 MP) |
|---|---|---|---|
| Generate (text → image) | $0.012 | $0.012 | $0.036667 |
| Edit (image → image) | $0.015333 | $0.015333 | $0.04 |
Every combination as JSON: /api/media/price-table?model=minimax-h3-image
README
The machine-readable contract for Minimax H3 Image contains the request schema, operations, limits, polling and response examples.
# Minimax H3 Image
Public model: minimax-h3-image
Create job: POST /api/media/generate
Check status: GET /api/media/jobs/{jobId}
## Input parameters
- `prompt` (text): text description; default: required
- `image_url` (URL): Public image URL; default: —
- `mode` (option selection): Generate (text → image) (default) · Edit (image → image); default: Generate (text → image)
- `aspect_ratio` (option selection): Auto (default) · 1:1 · 5:4 · 4:3 · 3:2 · 16:9 · 21:9 · 4:5 · 3:4 · 2:3 · 9:16; default: Auto
- `resolution` (option selection): 1K (~1 MP) · 2K (~4 MP) (default) · 4K (~16 MP); default: 2K (~4 MP)
- `width` (text / number): any value; default: —
- `height` (text / number): any value; default: —
- `expand_prompt` (yes/no): Yes (default) · No; default: Yes
- `output_format` (option selection): PNG (default) · JPEG; default: PNG
- `seed` (text / number): any value; default: —
- `image_urls` (Array<URLs>, 0–16 items): Public HTTP(S) URLs; default: —
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); default: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; default: —
- `input_file_ids` (Array<strings>): List of values; default: —
## Public variants
- `minimax-h3-image`: PixelFAQ about the Minimax H3 Image API
How much does Minimax H3 Image cost?
The price of Minimax H3 Image: from $0.012 per image. The price is calculated dynamically at the current exchange rate.
Is it compatible with the OpenAI SDK?
Yes, the API is fully OpenAI-compatible. Just change base_url to https://getvibeapi.com/v1 and set your key — the rest of the code stays the same.
Connect Minimax H3 Image right now
Sign up in a minute, pay per use, ready-made code above.
Get API key