Skip to main content
POST
Gemini 3 Pro Image VIP Image Generation
Note for users in mainland China: Please use https://toapis.cn as the API endpoint (Base URL). Replace https://toapis.com with https://toapis.cn in the examples in this document.

Version Options

The reference image count is the total number of input images; it does not represent the number of output images. The three versions use different model IDs, so follow the parameters and examples on the corresponding page.

Current Version

Use model: "gemini-3-pro-image-preview-vip" to select VIP, which supports text-to-image and image-to-image or image editing with up to 14 reference images. It suits edits or multi-image compositions that need 7 to 14 reference images. In multi-image requests, you can explain the purpose of each image in list order. Requests run asynchronously; after a successful submission, query the result by task ID.
image_urls only supports image URLs and does not accept base64 directly. First use the Upload Image API to get an accessible URL.

Authorizations

string
required
Authenticate with Bearer YOUR_API_KEY. Create an API Key in the console.

Body

string
default:"gemini-3-pro-image-preview-vip"
required
Fixed to gemini-3-pro-image-preview-vip. The standard model name and other aliases do not automatically switch to this VIP route.
string
required
Describe the image to generate or edit. When you pass multiple reference images, you can explain the purpose of each image in list order.
string
Image aspect ratio, for example 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.
integer
default:1
Generates 1 image per request. Use the number 1, not the string "1".
object[]
Optional list of reference images, up to 14. Omit this field for text-to-image. First use the Upload Image API to get an accessible image URL; do not pass base64 directly.Example: [{"url": "https://example.com/reference-1.png"}, {"url": "https://example.com/reference-2.png"}]. 14 is the limit for input reference images, not the number of output images from a single request.
object

Request Example

Replace the example URLs with reference image addresses that are actually reachable. You can keep adding reference images, but the total number in the list must not exceed 14. For a text-to-image request, simply remove image_urls and change the prompt.

Querying Results

The id in the submit response is the task ID. Use the Image Task Status endpoint to get the status and the final image. Task queries and Webhook callbacks follow the same conventions as the general async image endpoints.