---
title: "Generate Image (v1)"
method: POST
path: "/v1/images/generations"
tags: ["Images"]
---

# Generate Image (v1)

`POST /v1/images/generations`

Generate one or more images from a text prompt. Supports both synchronous and asynchronous modes.

## Headers

- `x-api-key` string

## Request body

- ImageGenerationRequest
  - `model` string, required — Image generation model (e.g., flux-1-schnell)
  - `prompt` string, required — The text prompt for image generation
  - `quality` string, nullable — Provider-specific quality preset
  - `size` string, nullable — Target image resolution (e.g., 1024x1024)
  - `n` integer, nullable — Number of images to generate
  - `response_format` 'url' | 'b64_json' — Output format per image
  - `steps` integer, nullable — Number of diffusion steps
  - `seed` integer, nullable — Random seed for reproducibility
  - `negative_prompt` string, nullable — Negative prompt for image generation
  - `guidance` number, nullable — Guidance scale for image generation
  - `async` boolean — Queue the request and return a task ID instead of waiting for the image result

## Response `200`

Successful Response

- ImageGenerationResponse
  - `created` integer, required — Unix timestamp of request creation
  - `data` ImageData[], required — Array of generated image objects
    - `url` string, nullable — Image URL (when response_format is 'url')
    - `b64_json` string, nullable — Base64-encoded image (when response_format is 'b64_json')
    - `revised_prompt` string, nullable — The actual prompt used after any modifications

## Other responses

- `400` — Bad Request - Invalid query parameters or body format.
- `401` — Unauthorized - Missing or invalid API key.
- `403` — Forbidden - Key does not have permission or is disabled.
- `422` — Unprocessable Entity - Request body validation failed.
- `429` — Too Many Requests - Rate limit exceeded.
- `500` — Internal Server Error - Internal error occurred.
- `502` — Bad Gateway - Provider error occurred.

---

[API](https://skmtc.dev/routeway/apis/routeway-api.md) · [All operations](https://skmtc.dev/routeway/apis/routeway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/routeway/routeway-api/revisions/b6f03282a96b/schema)