Gemini-3-Pro Image Generation

Generate images using Google Gemini 3 Pro model, with powerful image generation capabilities

POST /v1/images/generations

cURL

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "Futuristic city skyline with neon lights",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "resolution": "1K",
      "orientation": "landscape"
    }
  }'

200

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gemini-3-pro-image-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

• Google Gemini 3 Pro powerful image generation model (Nano banana2)
• Use model parameter to select gemini-3-pro-image-preview model
• Supports text-to-image generation
• Async task management, query results by task ID

Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload Image API first to upload images and get URLs, then call this endpoint.

Authorizations

Authorization · string · required

All endpoints require Bearer Token authentication

Get your API Key from the API Key Management Page

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

model · string · default: "gemini-3-pro-image-preview" · required

Image generation model name

Model alias: nano-banana-pro

Example: "gemini-3-pro-image-preview"

prompt · string · required

Text description for image generation

The upstream model input limit is 65,536 tokens. ToAPIs does not add a 1000-character cap.

size · string

Image generation aspect ratio

Supported formats:

• Ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

n · integer · default: 1

Number of images to generate

Fixed at 1

⚠️ Note: Must be a pure number (e.g. 1), do not add quotes, otherwise it will error

metadata · object

Metadata parameters for passing additional configuration options

Show Supported metadata fields

resolution · string · default: "1K"

Output image resolution

Supported values:

• 1K - 1K resolution (default)
• 2K - 2K resolution
• 4K - 4K resolution

orientation · string

Image orientation

Supported values:

• landscape - Landscape
• portrait - Portrait

image_urls · object[]

List of reference image URLs for image-to-image or image editing

Show Detailed field description

url · string · required

Image URL address

⚠️ URL format only (base64 no longer supported)

• Publicly accessible image URL (http:// or https://)
• Example: https://example.com/image.jpg
• You can use the Upload Image API to upload local images and get URLs

Limitations:

• Single image must not exceed 10MB
• Supported formats: .jpeg, .jpg, .png, .webp

Limit: Maximum 14 images

Response

id · string

Unique task identifier for status queries

object · string

Object type, always generation.task

model · string

Model name used

status · string

Task status

• queued - Queued for processing
• in_progress - Processing
• completed - Successfully completed
• failed - Failed

progress · integer

Task progress percentage (0-100)

created_at · integer

Task creation timestamp (Unix timestamp)

metadata · object

Task metadata

cURL

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "Futuristic city skyline with neon lights",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "resolution": "1K",
      "orientation": "landscape"
    }
  }'

200

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gemini-3-pro-image-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}