MiniMax H3 Image · Text to Image

Generate images from a text prompt with MiniMax H3 Image through the SeeAPI generations API. Submit an asynchronous task, then query its status or receive a Webhook when the images are ready.

Developer API pricing

Provider: SeeAPI

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

1K / 2K: 2.45 credits/gen (≈ $0.009/gen, without width)

4K: 7.49 credits/gen (≈ $0.028/gen, without width)

Price: 7.49 credits/gen (≈ $0.028/gen, width × height > 4,500,000) | 2.45 credits/gen (≈ $0.009/gen, width × height ≤ 4,500,000)

Request

POST/v1/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

A unique key that identifies this generation request, so a network retry does not create a duplicate task.

Use a new key for each distinct request.
Reuse the same key only when retrying the identical request body.
Maximum length is 255 characters.

max length: 255

Example:: order-20260818-001

Body Params

application/json

stringrequired

The model to run.

Must be minimax-h3-image on this page.

Allowed:minimax-h3-image

Default:: minimax-h3-image
Example:: minimax-h3-image

stringrequired

Selects the capability of the model. Use text-to-image to generate images from a text prompt.

Must be text-to-image on this page.
To edit existing images, use the image-edit Endpoint.

Allowed:text-to-image

Default:: text-to-image
Example:: text-to-image

stringoptional

Optional public Provider ID that handles the request.

Omit it to use the default Provider, seeapi.

Allowed:seeapi

Default:: seeapi
Example:: seeapi

objectrequired

Container for the generation parameters listed under the Provider below.

Fields are validated against the parameter rules of the selected Provider.
Put only that Provider's parameters in input.

Provider parameters

SeeAPIseeapiDefault Provider

stringrequired

Text description of the image to generate.

Required, 1–5000 characters.

min length: 1max length: 5000

Example:: A cinematic city at night

stringoptional

Aspect ratio of the output image.

Ignored when width and height are provided.

Allowed:auto1:15:44:54:33:43:22:316:99:1621:9

Default:: auto

stringoptional

Resolution tier of the output image.

Ignored when width and height are provided.

Allowed:1K2K4K

Default:: 2K

numberoptional

Custom output width in pixels. Use it together with height to set an exact size.

Must be sent together with height; range is 1–8192.
Width × height must be from 655,360 to 20,000,000 pixels.
The ratio width ÷ height must be between 1:3 and 3:1.
When set, aspect_ratio and resolution are ignored.
Billing uses total pixels (width × height), not the aspect ratio. Up to 4,500,000 pixels is billed at the 1K / 2K rate; above 4,500,000 and up to 20,000,000 pixels is billed at the 4K rate.
Two sizes with the same pixel count cost the same, whatever their ratio. Current rates are shown in the pricing block at the top of this page.

min: 1max: 8192

numberoptional

Custom output height in pixels. Use it together with width to set an exact size.

Must be sent together with width; range is 1–8192.
The pixel-count and ratio limits described under width apply to the width × height pair.
When set, aspect_ratio and resolution are ignored.

min: 1max: 8192

stringoptional

File format of the generated images.

Allowed values: png, jpeg. Default is png.

Allowed:pngjpeg

Default:: png

booleanoptional

Whether the prompt is automatically expanded and enriched before generation.

Set it to false to turn off automatic prompt expansion.

Default:: true

numberoptional

Integer seed that makes results easier to reproduce.

Optional. Range is 0–2147483647.
Using the same seed with identical parameters improves repeatability but does not guarantee identical images.

min: 0max: 2147483647

string <uri>optional

An HTTPS URL that receives a Webhook when the generation reaches a terminal state.

Optional. You can also poll the task status instead.
Must be an absolute HTTPS URL of up to 2048 characters.
Verify the Webhook signature before trusting the payload.

max length: 2048

Example:: https://client.example.com/webhooks/seeapi

Responses

202The generation task was accepted and is processing. Generation is asynchronous: this response describes the task, not the finished images.

Bodyapplication/json

Use generation.id to query the task status, or match it against the Webhook sent to callback_url.
Generated images are returned in the task result after the task succeeds.

objectrequired

stringrequired

Unique ID of the generation task. Use it to query status and results.

Example:: task_xxx

stringrequired

Example:: minimax-h3-image

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current task state. A newly created task is processing.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 2.45

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

true when this response replays an earlier request that used the same Idempotency-Key.

Example:: false

200The same Idempotency-Key and request body were already accepted, so the existing task is returned and no new task is created.

Bodyapplication/json

objectrequired

stringrequired

Unique ID of the generation task. Use it to query status and results.

Example:: task_xxx

stringrequired

Example:: minimax-h3-image

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current task state. A newly created task is processing.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 2.45

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

true when this response replays an earlier request that used the same Idempotency-Key.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "order-20260818-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "minimax-h3-image",
  "endpoint": "text-to-image",
  "provider": "seeapi",
  "input": {
    "prompt": "A cinematic city at night",
    "aspect_ratio": "auto",
    "resolution": "2K",
    "output_format": "png",
    "expand_prompt": true
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "minimax-h3-image",
    "endpoint": "text-to-image",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 2.45,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-08-18T10:00:00Z",
    "updated_at": "2026-08-18T10:00:00Z"
  },
  "idempotent": false
}

const response = await fetch("https://api.seeapi.com/v1/generations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Idempotency-Key": "order-20260818-001", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "minimax-h3-image", "endpoint": "text-to-image", "provider": "seeapi", "input": { "prompt": "A cinematic city at night", "aspect_ratio": "auto", "resolution": "2K", "output_format": "png", "expand_prompt": true }, "callback_url": "https://client.example.com/webhooks/seeapi" }) }); const result = await response.json();

{ "generation": { "id": "task_xxx", "model": "minimax-h3-image", "endpoint": "text-to-image", "provider": "seeapi", "status": "processing", "estimated_credits": 2.45, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:00:00Z" }, "idempotent": false }

Responses

202The generation task was accepted and is processing. Generation is asynchronous: this response describes the task, not the finished images.

Bodyapplication/json

Use generation.id to query the task status, or match it against the Webhook sent to callback_url.
Generated images are returned in the task result after the task succeeds.

objectrequired

stringrequired

Unique ID of the generation task. Use it to query status and results.

Example:: task_xxx

stringrequired

Example:: minimax-h3-image

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current task state. A newly created task is processing.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 2.45

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

true when this response replays an earlier request that used the same Idempotency-Key.

Example:: false

200The same Idempotency-Key and request body were already accepted, so the existing task is returned and no new task is created.

Bodyapplication/json

objectrequired

stringrequired

Unique ID of the generation task. Use it to query status and results.

Example:: task_xxx

stringrequired

Example:: minimax-h3-image

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current task state. A newly created task is processing.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 2.45

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

true when this response replays an earlier request that used the same Idempotency-Key.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable