Skip to content
Docs menu

Image models

GPT Image 1.5

On this page

gpt-image-1.5 — fast, high-fidelity AI image generation & editing.

modelIdgpt-image-1-5-text-to-image, gpt-image-1-5-image-to-image
Modalityimage
PricingSee this model on the Pricing page for the current per-call price (with your markup).

Operations

OperationmodelIdEndpointRequired input
Text To Imagegpt-image-1-5-text-to-imagePOST /api/v1/generateprompt, aspect_ratio, quality
Image To Imagegpt-image-1-5-image-to-imagePOST /api/v1/generateinput_urls, prompt, aspect_ratio, quality
Poll taskGET /api/v1/task/{id}?model=gpt-image-1-5-text-to-image

Text To Image — gpt-image-1-5-text-to-image

FieldTypeRequiredValues / example
promptstringYesA text description of the image you want to generate Max 3000 characters. (example: ## USER INPUT * **SUBJECT:** Times Square, New York City — tall buildings, giant digital billboards, busy streets, traffic, crowds, and glowing signs *… — full value in the request example)
aspect_ratiostringYesWidth-height ratio of the image, determining its visual form. (options: 1:1 | 2:3 | 3:2) (default: 3:2)
qualitystringYesQuality: 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":"## USER INPUT\n\n* **SUBJECT:** Times Square, New York City — tall buildings, giant digital billboards, busy streets, traffic, crowds, and glowing signs\n* **CHARACTERS:** English uppercase and lowercase letters, numbers 0–9, punctuation marks, and simple symbols\n* **FONT STYLE:** Modern bold urban typography, clean geometric shapes, mixed condensed and regular letterforms\n* **COLORS:** Bright red, electric blue, yellow, white, black, hot pink, and small neon green accents\n* **BACKGROUND:** Solid warm off-white\n\n## PROMPT\n\nCreate a clean typographic artwork that visually suggests **Times Square in New York City** using only readable letters, numbers, punctuation, and symbols.\n\nDo not draw Times Square first. Do not use buildings, streets, cars, people, billboards, or city shapes underneath the typography.\n\nInstead, arrange thousands of individual characters so that, when viewed from a distance, they collectively form the feeling of Times Square.\n\nUse larger and denser characters to suggest:\n\n* tall skyscrapers\n* giant advertising screens\n* crowded building facades\n* busy street intersections\n\nUse smaller, scattered characters to suggest:\n\n* crowds\n* traffic\n* distant lights\n* movement through the streets\n\nArrange the characters in strong vertical towers and diagonal street directions to create the recognizable energy of Times Square.\n\nThe center should feel busy and visually intense, while the outer edges gradually become lighter and more open.\n\nUse bright colors directly on the typography. Mix red, blue, yellow, white, pink, black, and small neon-green accents to capture the colorful nighttime advertising atmosphere of Times Square.\n\nEvery visible element must remain a readable character. Keep small gaps between letters so the viewer can clearly see that the image is made entirely from typography.\n\nSome characters may overlap, rotate, change size, or repeat, but they must not melt together or turn into normal illustrated shapes.\n\nKeep the outer edges irregular and open. Do not create a solid silhouette around the city.\n\nThe overall composition should feel:\n**busy, urban, energetic, colorful, modern, iconic, and unmistakably New York.**\n\n## STYLE\n\nClean flat digital typography, crisp edges, front-facing composition, generous negative space around the main formation.\n\nAt close range, viewers should see individual letters and numbers.\n\nAt a distance, the complete character field should suggest **Times Square with towering billboards, streets, traffic, crowds, and intense city energy.**\n\n## DO NOT USE\n\n* drawn buildings\n* city silhouettes\n* clipping masks\n* filled shapes\n* vector outlines\n* photographic backgrounds\n* real billboard images\n* realistic cars or people\n* gradients\n* shadows\n* 3D effects\n* perspective-heavy rendering\n* textures\n* logos\n* frames\n* mockups\n\n## FINAL LOOK\n\nA sophisticated typographic interpretation of **Times Square, New York**, created entirely from readable characters, with colorfu","aspect_ratio":"3:2","quality":"medium"}}'

Image To Image — gpt-image-1-5-image-to-image

FieldTypeRequiredValues / example
input_urlsstring[]YesUpload an image file to use as input for the API (image URL)
promptstringYesA text description of the image you want to generate Max 3000 characters. (example: 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… — full value in the request example)
aspect_ratiostringYesWidth-height ratio of the image, determining its visual form. (options: 1:1 | 2:3 | 3:2) (default: 3:2)
qualitystringYesQuality: 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://you.bot/examples/grok-imagine-text-to-image.jpg"],"prompt":"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":"3:2","quality":"medium"}}'