Image models
gpt-image-1.5
On this page
gpt-image-1.5 — fast, high-fidelity AI image generation & editing.
| modelId | gpt-image-1-5-text-to-image, gpt-image-1-5-image-to-image |
| Modality | image |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Text To Image | gpt-image-1-5-text-to-image | POST /api/v1/generate | prompt, aspect_ratio, quality |
| Image To Image | gpt-image-1-5-image-to-image | POST /api/v1/generate | input_urls, prompt, aspect_ratio, quality |
| Poll task | — | GET /api/v1/task/{id}?model=gpt-image-1-5-text-to-image | — |
Text To Image — gpt-image-1-5-text-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | A text description of the image you want to generate Max 3000 characters. (default: An origami crane folded from translucent amber paper perched on a moss-covered stone, backlit by a single shaft of forest sunlight, delicate paper fibers glowing, ultra-sharp macro detail.) |
| aspect_ratio | string | Yes | Width-height ratio of the image, determining its visual form. (options: 1:1 | 2:3 | 3:2) (default: 3:2) |
| quality | string | Yes | Quality: medium=balanced, high=slow/detailed. (options: medium | high) (default: medium) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gpt-image-1-5-text-to-image","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","aspect_ratio":"3:2","quality":"medium"}}'Image To Image — gpt-image-1-5-image-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| input_urls | string[] | Yes | Upload an image file to use as input for the API (image URL) |
| prompt | string | Yes | A text description of the image you want to generate Max 3000 characters. (default: Restyle this into a deep winter landscape — frost every branch, blanket the ground in fresh untouched snow, and cast it all in soft blue pre-dawn light with delicate flurries drifting down.) |
| aspect_ratio | string | Yes | Width-height ratio of the image, determining its visual form. (options: 1:1 | 2:3 | 3:2) (default: 3:2) |
| quality | string | Yes | Quality: medium=balanced, high=slow/detailed. (options: medium | high) (default: medium) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"gpt-image-1-5-image-to-image","input":{"input_urls":["https://example.com/input.jpg"],"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","aspect_ratio":"3:2","quality":"medium"}}'