Skip to main content
POST
Billable request: generate an image with gpt-image-2-web

Generate an image synchronously

quality is forwarded; the selected upstream determines its effect.

Submit and poll an asynchronous generation

Edit one source image

Queue a multi-image edit with JSON

Each decoded source must not exceed 20 MiB and all source images together must remain within 64 MiB. Poll the returned task with the bounded loop above; successful output remains available for 24 hours.

Test this model online

The embedded operation fixes gpt-image-2-web and exposes the three documented sizes plus forwarded quality values.
Try it sends a real USD 0.03 request at the current price. Use a development key and do not share generated cURL that contains it.

Authorizations

Authorization
string
header
required

YingTu API key.

Body

application/json
model
enum<string>
required
Available options:
gpt-image-2-web
Example:

"gpt-image-2-web"

prompt
string
required
Minimum string length: 1
Example:

"A blue ceramic teapot on a pale table, no text"

size
enum<string>

Current public presets. Set size explicitly for predictable dimensions; the 4K landscape value is 3840x2160.

Available options:
1024x1024,
2048x2048,
3840x2160
Example:

"1024x1024"

quality
enum<string>

Forwarded for both GPT Image routes. The selected upstream determines how the requested value affects the result.

Available options:
low,
medium,
high,
auto
Example:

"low"

n
enum<integer>
default:1

The documented subset returns one image.

Available options:
1

Response

Complete GPT Image response

created
integer<int64>
required

Unix timestamp in seconds.

data
object[]
required
Required array length: 1 element
size
string

Output size when returned by the selected GPT Image route.

quality
string

Quality value reported by the selected GPT Image route.

usage
object
Last modified on September 3, 2026