Properties
| Name | Type | Description |
|---|---|---|
| prompt | string | A text description of the desired image(s). The maximum length is 1000 characters for DALL-E 2 and 32000 characters for gpt-image-1. |
| model | string | The model to use for image generation. Defaults to dall-e-2. |
| n | integer | The number of images to generate. Must be between 1 and 10. For DALL-E 3, only n=1 is supported. |
| quality | string | The quality of the image. hd creates images with finer details and greater consistency. For gpt-image-1 use low, medium, high, or auto. |
| response_format | string | The format in which the generated images are returned. Must be one of url or b64_json. URLs are only valid for 60 minutes. |
| size | string | The size of the generated images. Must be one of the supported sizes for the model being used. |
| style | string | The style of the generated images. Vivid generates hyper-real and dramatic images. Natural produces more natural, less hyper-real images. Only supported for DALL-E 3. |
| user | string | A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "CreateImageRequest",
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "A text description of the desired image(s). The maximum length is 1000 characters for DALL-E 2 and 32000 characters for gpt-image-1."
},
"model": {
"type": "string",
"description": "The model to use for image generation. Defaults to dall-e-2."
},
"n": {
"type": "integer",
"description": "The number of images to generate. Must be between 1 and 10. For DALL-E 3, only n=1 is supported."
},
"quality": {
"type": "string",
"description": "The quality of the image. hd creates images with finer details and greater consistency. For gpt-image-1 use low, medium, high, or auto."
},
"response_format": {
"type": "string",
"description": "The format in which the generated images are returned. Must be one of url or b64_json. URLs are only valid for 60 minutes."
},
"size": {
"type": "string",
"description": "The size of the generated images. Must be one of the supported sizes for the model being used."
},
"style": {
"type": "string",
"description": "The style of the generated images. Vivid generates hyper-real and dramatic images. Natural produces more natural, less hyper-real images. Only supported for DALL-E 3."
},
"user": {
"type": "string",
"description": "A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/openai-images-create-image-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.