> ## Documentation Index > Fetch the complete documentation index at: https://docs.goenhance.ai/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax-H3-Image > MiniMax-H3-Image in a single endpoint: text to image, or editing and combining up to 3 reference images. Strong at photorealistic people, skin and material texture. Omit `image_list` for text to image; pass it to edit. Always returns a single PNG. **Pricing** — flat per image by resolution tier. Text to image and editing cost the same, and reference images add nothing: | image_size | Tokens | USD | |---|---|---| | 1K (about 1 MP, default) | 1 | $0.02 | | 2K (about 4 MP, native) | 4 | $0.08 | **Editing and reference images** - Up to 3 images in `image_list`. Refer to them in the prompt as ``, ``, `` in `image_list` order, for example `Put the hat from on the woman in `. - The output keeps the aspect ratio of the first image, so `ratio` must be `auto` (or omitted) when editing. Any other ratio is rejected before tokens are deducted. - Each reference is resized to about 1 MP at 1K and about 4 MP at 2K. **Text in images** — short English and Chinese text such as signs and titles renders well. Long or dense text is less reliable; for posters, menus and infographics, [MOSS-Image](/api-reference/image-api/moss-image) is a better fit. **Timing** — about 10 to 20 seconds of processing for text to image, and about 20 to 60 seconds for editing at 2K (more reference images take longer), plus queue time. The first request after a quiet period can wait several minutes while capacity starts up. ## OpenAPI ````yaml api-reference/image-api/openapi-minimax-h3-image.json POST /api/v1/images/generations openapi: 3.1.0 info: title: GoEnhance API - MiniMax-H3-Image description: MiniMax-H3-Image version: 1.0.0 servers: - url: https://api.goenhance.ai security: [] paths: /api/v1/images/generations: post: tags: - ImageAPI summary: MiniMax-H3-Image description: >- MiniMax-H3-Image in a single endpoint: text to image, or editing and combining up to 3 reference images. Strong at photorealistic people, skin and material texture. Omit `image_list` for text to image; pass it to edit. Always returns a single PNG. **Pricing** — flat per image by resolution tier. Text to image and editing cost the same, and reference images add nothing: | image_size | Tokens | USD | |---|---|---| | 1K (about 1 MP, default) | 1 | $0.02 | | 2K (about 4 MP, native) | 4 | $0.08 | **Editing and reference images** - Up to 3 images in `image_list`. Refer to them in the prompt as ``, ``, `` in `image_list` order, for example `Put the hat from on the woman in `. - The output keeps the aspect ratio of the first image, so `ratio` must be `auto` (or omitted) when editing. Any other ratio is rejected before tokens are deducted. - Each reference is resized to about 1 MP at 1K and about 4 MP at 2K. **Text in images** — short English and Chinese text such as signs and titles renders well. Long or dense text is less reliable; for posters, menus and infographics, [MOSS-Image](/api-reference/image-api/moss-image) is a better fit. **Timing** — about 10 to 20 seconds of processing for text to image, and about 20 to 60 seconds for editing at 2K (more reference images take longer), plus queue time. The first request after a quiet period can wait several minutes while capacity starts up. parameters: - name: Authorization in: header description: '' required: false example: '{{Authorization}}' schema: type: string requestBody: content: application/json: schema: type: object properties: model: type: string enum: - minimax-h3-image description: Model name. Must be `minimax-h3-image`. prompt: type: string maxLength: 4000 description: >- What to generate, or the edit instruction. Required. Refer to reference images as `` … ``. Any language is accepted, and text you ask for in the image is rendered as written. image_list: type: array items: type: object properties: url: type: string format: uri required: - url minItems: 1 maxItems: 3 description: >- Optional reference images for editing, [{"url": "https://..."}]. Up to 3. The array order is the `` order, and the output follows the aspect ratio of the first image. Reference images do not change the price. ratio: type: string enum: - auto - '1:1' - '2:3' - '3:2' - '3:4' - '4:3' - '9:16' - '16:9' - '21:9' default: auto description: >- Aspect ratio for text to image. `auto` means 1:1 for text to image. When editing, only `auto` is accepted: the output follows the first reference image. image_size: type: string enum: - 1K - 2K default: 1K description: >- Resolution tier, also the price tier. 1K is about 1 megapixel, 2K about 4 megapixels (native). Case-insensitive. seed: type: integer minimum: 0 maximum: 2147483647 description: Optional. Fixing the seed makes results more reproducible. custom_callback_url: type: string format: uri description: >- Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt. example: https://your-server.com/goenhance/callback required: - model - prompt example: model: minimax-h3-image prompt: >- A late-night ramen shop on a rainy street, red lanterns, a neon sign that reads "OPEN 24H", cinematic lighting ratio: '16:9' image_size: 2K responses: '200': description: '' content: application/json: schema: type: object properties: code: type: integer msg: type: string data: type: object properties: img_uuid: type: string cost: type: number description: >- Tokens deducted for this request. This is the amount actually charged, so it already reflects any discount active on your account and can be lower than the listed price. Tokens are deducted when the task is accepted, and refunded automatically if the generation ends in failure. example: 1 required: - img_uuid - cost required: - code - msg - data examples: '1': summary: Success value: code: 0 msg: Success data: img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5 cost: 1 '2': summary: Insufficient tokens value: code: 100 msg: tokens is not enough quota: summary: API key quota exceeded value: code: 101 msg: 'API key quota exceeded: 4990 of 5000 tokens used (monthly)' headers: {} '401': description: '' content: application/json: schema: type: object properties: code: type: integer msg: type: string required: - code - msg headers: {} deprecated: false security: [] ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.