---
title: "Create image generation"
method: POST
path: "/v1/images/generations"
tags: ["images"]
---

# Create image generation

`POST /v1/images/generations`

This handler simply forwards the request to the image generations service and returns the response.

# Arguments

* `state` - Application state containing service URLs
* `payload` - The image generation request body

# Returns

Returns the JSON response from the image generations service

# Errors

Returns a `AtomaServiceError::InternalError` if:
- The image generations service request fails
- Response parsing fails

## Request body

- unknown

## Response `200`

Images generated successfully

- unknown

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/atomaai/apis/atoma-service.md) · [All operations](https://skmtc.net/atomaai/apis/atoma-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atomaai/atoma-service/revisions/a3d329cb3125/schema)
