Gemini-3-Pro-Image-preview (Nano banana Pro) Image Generation

• Asynchronous processing mode, returns task ID for subsequent queries
• High-quality image generation, professional-grade image creation
• Generated image links are valid for 24 hours, please save them promptly

POST /v1/images/generations

cURL

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

200

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

cURL

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview",
    "prompt": "A bamboo forest path under moonlight",
    "size": "1:1",
    "n": 1,
    "resolution": "1K"
  }'

200

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization · string · required

All APIs require authentication using Bearer Token

Get API Key:

Visit API Key Management Page to obtain your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

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

Image generation model name

Supported models:

• gemini-3-pro-image-preview - Standard version
• gemini-3-pro-image-preview-official - Official version

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

prompt · string · required

Text description for image generation

size · string

Image generation size

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

Number of images to generate

Range: 1-4 (minimum 1, maximum 4)

Default: 1

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

resolution · string

Output image resolution

Supported values:

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

⚠️ Note: Generating 4K images with base64 format takes longer processing time

official_fallback · boolean · default: "false"

Whether to use the official channel fallback

• false: Do not use (default)
• true: Use official channel

When using the official channel (gemini-3-pro-image-preview-official), this parameter cannot be used.

image_urls · array

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

💡 Quick Fill (Try it area):

1. Click ”+ Add an item” to add an image URL
2. Enter the complete image URL address or base64 data

Show Detailed field description

Each element in the array is a string, supporting two formats:

1. Complete image URL address

• Publicly accessible image URL (http:// or https://)
• Example: "https://example.com/image.jpg"

2. Base64 encoded format

• Must use complete Data URI format
• Format: data:image/{format};base64,{base64data}
• Supported image formats: jpeg, png, webp, etc.
• Example: "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg..."
• ⚠️ Note: Must include the data:image/jpeg;base64, prefix

Limitations:

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

Limit: Maximum 14 images

Response

code · integer

Response status code

data · array

Response data array

Show Properties

status · string

Task status

• submitted - Submitted

task_id · string

Unique task identifier