MiniMax H3 Image · Image Edit

Edit or combine up to 16 reference images with a text instruction using 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)

Add-on

Additional reference images: +0.68 credits/image (≈ $0.003/image) (billed per additional image)

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 image-edit to edit or combine reference images with a text instruction.

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

Allowed:image-edit

Default:: image-edit
Example:: image-edit

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

array <uri>required

List of reference image URLs to edit or combine. Reference order is preserved.

Required. Provide 1–16 images.
Supported formats: JPEG, PNG, WEBP. Each image can be up to 20 MB.
In the prompt, refer to images by position.
Billing also depends on the number of reference images.

min: 1max: 16min items: 1max items: 16

Example:: ["https://client.example.com/input.png"]

stringrequired

Text instruction describing how to edit or combine the reference images.

Required, 1–5000 characters.

min length: 1max length: 5000

Example:: A cinematic city at night

stringoptional

Aspect ratio of the output image.

Default is auto.
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.

Boolean. Default is true.
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:: image-edit

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:: 3.13

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:: image-edit

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:: 3.13

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": "image-edit",
  "provider": "seeapi",
  "input": {
    "input_images": [
      "https://client.example.com/input.png"
    ],
    "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": "image-edit",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 3.13,
    "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": "image-edit", "provider": "seeapi", "input": { "input_images": [ "https://client.example.com/input.png" ], "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": "image-edit", "provider": "seeapi", "status": "processing", "estimated_credits": 3.13, "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:: image-edit

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:: 3.13

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:: image-edit

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:: 3.13

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