---
title: "Generate images from text"
method: POST
path: "/images/generations"
tags: ["images"]
---

# Generate images from text

`POST /images/generations`

## Request

- Base URL: `https://api.krater.ai/v1`
- URL: `https://api.krater.ai/v1/images/generations`
- Auth: HTTP bearer

Generate one or more images from a text prompt. Supported models include flux-2 (and its pro, max, flex, flash, turbo and klein variants), gpt-image-2, grok-imagine, nano-banana, nano-banana-2, nano-banana-2-lite, recraft, ideogram, seedream, z-image-turbo and kling. Credits vary by model, from 2 to about 63 per image.

## Request body

- ImageGenerationRequest
  - `prompt` string, required: Text description of the image to generate.
  - `model` string: Image model identifier.
  - `size` string: Output size or aspect ratio, model dependent.
  - `n` integer: Number of images to generate.
  - `resolution` string: Output resolution for models that support it, for example 1K, 2K or 4K.
  - `quality` string: Quality setting for models that support it, for example low, medium or high.
  - `rendering_speed` string: Rendering speed for Ideogram models, for example TURBO.
  - `style` string: Style preset for models that support it.
  - `version` string: Specific model version to pin, when the model has multiple versions.

## Response `200`

Generated image URLs.

- ImageResponse
  - `created` integer, required: Unix timestamp.
  - `data` object[], required
    - `url` string, uri, required: URL of the generated image.

## Other responses

- `400`: Invalid request body or parameters.
- `401`: Missing or invalid API key. Pass Authorization: Bearer kr_live_...
- `402`: Not enough credits, or the API key's daily credit cap is reached.
- `429`: Rate limit exceeded (default 60 requests per minute per key). Includes a Retry-After header.

---

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