---
title: "Create Image"
method: POST
path: "/images/generations"
tags: ["Images"]
---

# Create Image

`POST /images/generations`

## Request

- Base URL: `https://gateway.obiguard.ai/v1`
- URL: `https://gateway.obiguard.ai/v1/images/generations`
- Auth: API key in header `x-obiguard-api-key`

## 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](https://platform.openai.com/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.dev/obiguard/apis/obiguard-api.md) - [All operations](https://skmtc.dev/obiguard/apis/obiguard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/obiguard/apis/obiguard-api/revisions/ddd03c93e108?raw)