---
title: "Generate an image using AI"
method: POST
path: "/api/ai/images/generate/v3"
tags: ["AI Services"]
---

# Generate an image using AI

`POST /api/ai/images/generate/v3`

## Request

- Base URL: `https://api.worqhat.com`
- URL: `https://api.worqhat.com/api/ai/images/generate/v3`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/docs/api/ai/images/generate/v3/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint is used to generate an image using AI. It accepts a JSON object containing the image generation parameters and returns the generated image. The ImageCon V2 model is our Fastest and basic model for generating images that can handle image sizes of `1024x1024` and `1344x1024`.

## Request body

- object
  - `prompt` string[]: The prompt and descriptions to be used for generating the image.
  - `image_style` string: The style of the image to be generated. You can choose between `Abstract`, `Landscape`, `Portrait`, `Still Life`, `Animal`, `Anime`, `Architecture`, etc.
  - `output_type` 'url' | 'blob': The type of output to be generated. You can choose between `url` and `blob` . `URL` will return a cloud-hosted Temporary URL for the generated image, you need to handle the image download on your end. `blob` will return the image as a base64 encoded string.
  - `orientation` 'square' | 'portrait' | 'landscape': The orientation of the image to be generated. You can choose between `square` , `portrait`, and `landscape`. `square` will generate a square image of dimensions 1024x1024. `portrait` will generate a portrait image of dimensions 1024x1344. `landscape` will generate a landscape image of dimensions 1344x1024.

## Response `200`

Image generated successfully

- object
  - `status` string: Status indicating the success of the image generation.
  - `image` string: The generated image.
  - `processing_time` integer: The time taken to process the request, in milliseconds.
  - `processing_id` string: A universally unique identifier for the request. This can be used to track the request in the logs.
  - `processing_count` integer: The number of times the request has been processed. This is what is considered in the Billing Process. This is either the number of times the image is processed or the number of words that the server processes.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `406`: Not Acceptable
- `500`: Internal Server Error

## Changes

- **2023-10-20** `871850b7231f`: 5 warning, 18 info
  - removed the request property `height`
  - removed the request property `width`
  - removed the optional property `content` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - …19 more
- **2023-08-15** `b5ffe2a9748f`: 6 breaking, 17 info
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `404`
  - …19 more
- **2023-08-04** `be85a8f8fc8c`: 6 breaking, 15 warning
  - the response's body type changed from `object` to no type for status `200`
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `401`
  - the response's body type changed from `object` to no type for status `404`
  - …17 more
- **2023-08-04** `d6dbf089e00d`: 1 info
  - the endpoint scheme security `bearerAuth` was removed from the API
- **2023-08-03** `87a2697d00bf`: 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `ApiKeyAuth AND OrgKeyAuth` was removed from the API

[Operation history](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/changes/api/ai/images/generate/v3/post.md)

---

[API](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2.md) - [All operations](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/llms.txt) - [OpenAPI document](https://skmtc.dev/worqhat/apis/worqhat-ai-api-endpoints-2/revisions/fc369f69a3e6?raw)