Gemini-2.5-Flash Image Generation

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "A cat in a spacesuit walking on the moon",
    "size": "1:1",
    "n": 1
  }'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "Transform this cat into cartoon style",
    "size": "1:1",
    "n": 1,
    "image_urls": ["https://example.com/cat.jpg"]
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-2.5-flash-image-preview",
        "prompt": "A cat in a spacesuit walking on the moon",
        "size": "1:1",
        "n": 1
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-2.5-flash-image-preview",
        "prompt": "Transform this cat into cartoon style",
        "size": "1:1",
        "n": 1,
        "image_urls": ["https://example.com/cat.jpg"]
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-2.5-flash-image-preview',
    prompt: 'A cat in a spacesuit walking on the moon',
    size: '1:1',
    n: 1
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-2.5-flash-image-preview',
    prompt: 'Transform this cat into cartoon style',
    size: '1:1',
    n: 1,
    image_urls: ['https://example.com/cat.jpg']
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

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

POST

images

generations

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "A cat in a spacesuit walking on the moon",
    "size": "1:1",
    "n": 1
  }'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "Transform this cat into cartoon style",
    "size": "1:1",
    "n": 1,
    "image_urls": ["https://example.com/cat.jpg"]
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-2.5-flash-image-preview",
        "prompt": "A cat in a spacesuit walking on the moon",
        "size": "1:1",
        "n": 1
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-2.5-flash-image-preview",
        "prompt": "Transform this cat into cartoon style",
        "size": "1:1",
        "n": 1,
        "image_urls": ["https://example.com/cat.jpg"]
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-2.5-flash-image-preview',
    prompt: 'A cat in a spacesuit walking on the moon',
    size: '1:1',
    n: 1
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-2.5-flash-image-preview',
    prompt: 'Transform this cat into cartoon style',
    size: '1:1',
    n: 1,
    image_urls: ['https://example.com/cat.jpg']
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

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

Google Gemini 2.5 Flash efficient image generation model (Nano banana)
Use model parameter to select gemini-2.5-flash-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

string

required

All endpoints require Bearer Token authenticationGet your API Key from the API Key Management PageAdd to request header:

Authorization: Bearer YOUR_API_KEY

Body

string

default:"gemini-2.5-flash-image-preview"

required

Image generation model nameModel alias: nano-bananaExample: "gemini-2.5-flash-image-preview"

string

required

Text description for image generationMaximum 1000 characters

string

Image size ratioSupported formats:

Value	Description	Pixels (Reference)
`1:1`	Square	1024x1024
`16:9`	Landscape wide	1792x1024
`9:16`	Portrait tall	1024x1792
`4:3`	Landscape standard	1365x1024
`3:4`	Portrait standard	1024x1365
`3:2`	Landscape photo	1536x1024
`2:3`	Portrait photo	1024x1536

integer

default:1

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

object[]

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

Show Detailed field description

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

object

Metadata parameters for passing additional configuration options

Show Supported metadata fields

string

default:"1K"

Output image resolutionSupported values:

1K - 1K resolution (default, only supported option)

string

Image orientationSupported values:

landscape - Landscape
portrait - Portrait

Response

string

Unique task identifier for status queries

string

Object type, always generation.task

string

Model name used

string

Task status

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

integer

Task progress percentage (0-100)

integer

Task creation timestamp (Unix timestamp)

object

Task metadata

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "A cat in a spacesuit walking on the moon",
    "size": "1:1",
    "n": 1
  }'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "Transform this cat into cartoon style",
    "size": "1:1",
    "n": 1,
    "image_urls": ["https://example.com/cat.jpg"]
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-2.5-flash-image-preview",
        "prompt": "A cat in a spacesuit walking on the moon",
        "size": "1:1",
        "n": 1
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-2.5-flash-image-preview",
        "prompt": "Transform this cat into cartoon style",
        "size": "1:1",
        "n": 1,
        "image_urls": ["https://example.com/cat.jpg"]
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-2.5-flash-image-preview',
    prompt: 'A cat in a spacesuit walking on the moon',
    size: '1:1',
    n: 1
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-2.5-flash-image-preview',
    prompt: 'Transform this cat into cartoon style',
    size: '1:1',
    n: 1,
    image_urls: ['https://example.com/cat.jpg']
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

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

Gemini-3.1-Flash-Image Gemini-3-Pro-Image Official

Overview

Quick Start

Chat API

Image API

Video API

Task Management

File Uploads

Account

FAQs

Authorizations

Body

Response

​Authorizations

​Body

​Response

Authorizations

Body

Response