Skip to main content
POST
Billable request (defaults to 1K): generate an image with gemini-3-pro-image

Generate a 4K campaign asset

Python
A 4K response can contain several megabytes of decoded image data and a larger Base64 payload. Allow a longer timeout and keep image data out of ordinary logs.

Queue a Pro task

cURL
Persist the returned task ID and use bounded polling. Increase the size only when the delivered asset needs it.

Edit a product source

Representative response

The counts and JPEG encoding illustrate the response shape; they are not fixed. Scan all parts, use the returned MIME, and avoid logging the Base64 field.

Test this model online

The embedded operation uses the stable gemini-3-pro-image ID and exposes ten ratios plus 1K, 2K, and 4K. Begin with 1K unless the test needs more pixels.
Pro requests are billable. Mintlify includes the development key in its generated cURL, so do not share authenticated screenshots or copied commands.

Plan Pro parameters

Review size, ratio, transport, and logging limits.

Compare against Flash

Measure accepted output and retry cost before scaling.

Authorizations

Authorization
string
header
required

YingTu API key.

Body

application/json
contents
Message · object[]
required

Prompt and optional source image.

Minimum array length: 1
generationConfig
Output settings · object

Response

Complete Gemini response

candidates
object[]
required
promptFeedback
object
usageMetadata
object
modelVersion
string

The model version that produced the response.

Example:

"gemini-3-pro-image"

responseId
string

Provider response identifier.

Example:

"response_example"

createTime
string<date-time>

Creation time when supplied by the selected model.

Last modified on September 3, 2026