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

# Create image (image generation)

`POST /v1/images/generations`

## Request body

- CoreImageGenerationRequest
  - `model` string, required
  - `n` integer
  - `prompt` string, required
  - `provider` string — Provider is gateway routing metadata, stripped before dispatching upstream.
  - `quality` string
  - `response_format` string
  - `size` string
  - `stream` boolean — Stream is typed only so the gateway can reject it: streaming image generation returns server-sent events, which this endpoint does not relay.
  - `user` string

## Response `200`

OK

- CoreImageGenerationResponse
  - `background` string
  - `created` integer
  - `data` CoreImageData[]
    - `b64_json` string
    - `revised_prompt` string
    - `url` string
  - `output_format` string
  - `provider` string — Provider is a gateway addition, stamped like every other routed response, so clients can tell which provider served the request.
  - `quality` string
  - `size` string
  - `usage` CoreImageUsage
    - `input_tokens` integer
    - `input_tokens_details` CoreImageTokenDetails
      - `image_tokens` integer
      - `text_tokens` integer
    - `output_tokens` integer
    - `total_tokens` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Too Many Requests
- `502` — Bad Gateway

---

[API](https://skmtc.net/enterpilot/apis/gomodel-api.md) · [All operations](https://skmtc.net/enterpilot/apis/gomodel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enterpilot/gomodel-api/revisions/0e1616bb3dd4/schema)