Generate images from text prompts

post

https://api.macpaw.com/ai/api/v1/images/generations

Creates images based on a text prompt using AI image generation models. Supported models include openai/dall-e-2, openai/dall-e-3, and openai/gpt-image-1. For detailed information about request and response parameters, see OpenAI Images API.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request parameters follow OpenAI Images API format. See OpenAI documentation for details.

prompt

string

required

Text description of the desired image. Maximum length: 1000 chars for dall-e-2, 4000 chars for dall-e-3.

model

string

Model for image generation in <provider>/<model> format.

integer

1 to 10

Defaults to 1

Number of images to generate. For dall-e-3, only n=1 is supported.

quality

string

enum

Defaults to standard

Image quality. hd creates images with finer details. Only supported for dall-e-3.

Allowed:

response_format

string

enum

Defaults to url

Format of the returned images.

Allowed:

size

string

enum

Defaults to 1024x1024

Image size. dall-e-2: 256x256, 512x512, 1024x1024. dall-e-3: 1024x1024, 1792x1024, 1024x1792.

Allowed:

style

string

enum

Defaults to vivid

Image style. Only supported for dall-e-3.

Allowed:

user

string

Optional end-user identifier for abuse monitoring.

Responses

200Image generated successfully

400Bad request (e.g. empty prompt, unsupported parameter combination)

401Invalid token

402Insufficient credits

422Validation error (e.g. unsupported size or invalid n value)

429Rate limit exceeded

500Internal error