---
title: "Image Generation"
method: POST
path: "/v1/image_generation"
tags: ["Image"]
---

# Image Generation

`POST /v1/image_generation`

## Request

- Base URL: `https://api.minimax.io`
- URL: `https://api.minimax.io/v1/image_generation`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/minimax/apis/minimax-api-2/docs/v1/image_generation/post.ts> (a function with typed inputs; its response is checked against the schema)

Generate images from text prompt

## Request body

- ImageGenerationReq
  - `prompt` string, required: Text prompt for image generation
  - `model` string, required: Model to use for image generation
  - `prompt_optimizer` boolean: Whether to optimize the prompt
  - `seed` integer: Random seed for generation
  - `aspect_ratio` string: Aspect ratio of the generated image
  - `response_format` 'url' | 'base64': Image data format
  - `n` integer: Number of images to generate
  - `metadata` object: Additional metadata
  - `subject_reference` ImageSubjectReference[]: Subject reference images
    - `type` string, required: Reference type
    - `image_file` string, required: Reference image file
  - `style` ImageStyle
    - `type` '漫画' | '元气' | '中世纪' | '水彩', required: Image style type
    - `weight` number, double: Style weight
  - `width` integer: Image width
  - `height` integer: Image height
  - `aigc_watermark` boolean: Whether to add AIGC watermark

## Response `200`

Successful response

- ImageGenerationResp
  - `id` string: Trace ID
  - `data` ImageObject
    - `image_urls` string[]: Generated image URLs
    - `image_base64` string[]: Generated images in base64 format
  - `metadata` object: Additional metadata

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/minimax/apis/minimax-api-2.md) - [All operations](https://skmtc.dev/minimax/apis/minimax-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/minimax/apis/minimax-api-2/revisions/b18c2ab45c0e?raw)