---
title: "Creates an image given a prompt."
method: POST
path: "/images/generations"
tags: ["Images"]
---

# Creates an image given a prompt.

`POST /images/generations`

## Request body

- CreateImageRequest
  - `prompt` string, required — A text description of the desired image(s). The maximum length is 1000 characters for `dall-e-2` and 4000 characters for `dall-e-3`.
  - `model` union — The model to use for image generation.
    - string
    - 'dall-e-2' | 'dall-e-3'
  - `n` integer, nullable — The number of images to generate. Must be between 1 and 10. For `dall-e-3`, only `n=1` is supported.
  - `quality` 'standard' | 'hd' — The quality of the image that will be generated. `hd` creates images with finer details and greater consistency across the image. This param is only supported for `dall-e-3`.
  - `response_format` 'url' | 'b64_json', nullable — The format in which the generated images are returned. Must be one of `url` or `b64_json`. URLs are only valid for 60 minutes after the image has been generated.
  - `size` '256x256' | '512x512' | '1024x1024' | '1792x1024' | '1024x1792', nullable — The size of the generated images. Must be one of `256x256`, `512x512`, or `1024x1024` for `dall-e-2`. Must be one of `1024x1024`, `1792x1024`, or `1024x1792` for `dall-e-3` models.
  - `style` 'vivid' | 'natural', nullable — The style of the generated images. Must be one of `vivid` or `natural`. Vivid causes the model to lean towards generating hyper-real and dramatic images. Natural causes the model to produce more natural, less hyper-real looking images. This param is only supported for `dall-e-3`.
  - `user` string — A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. [Learn more](/docs/guides/safety-best-practices/end-user-ids).

## Response `200`

OK

- ImagesResponse
  - `created` integer, required
  - `data` Image[], required
    - `b64_json` string — The base64-encoded JSON of the generated image, if `response_format` is `b64_json`.
    - `url` string — The URL of the generated image, if `response_format` is `url` (default).
    - `revised_prompt` string — The prompt that was used to generate the image, if there was any revision to the prompt.

---

[API](https://skmtc.net/omnistack-sh/apis/openai-api.md) · [All operations](https://skmtc.net/omnistack-sh/apis/openai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omnistack-sh/openai-api/versions/a127ad1d97cb/schema)