ToAPIsToAPIs
Gemini-2.5-Flash-Image-preview

Gemini-2.5-Flash 画像生成

Generate images using Google Gemini 2.5 Flash model, fast and efficient

POST
/v1/images/generations

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

  • Google Gemini 2.5 Flash efficient image generation model
  • 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 画像API first to upload images and get URLs, then call this endpoint.

Authorizations

Authorizationstringヘッダー必須

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

modelstringボディ必須デフォルト: gemini-2.5-flash-image-preview

Image generation model name

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

promptstringボディ必須

Text description for image generation

Maximum 1000 characters

sizestringボディ

Image size ratio

Supported formats:

Value説明Pixels (Reference)
1:1Square1024x1024
16:9Landscape wide1792x1024
9:16Portrait tall1024x1792
4:3Landscape standard1365x1024
3:4Portrait standard1024x1365
3:2Landscape photo1536x1024
2:3Portrait photo1024x1536
nintegerボディデフォルト: 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

image_urlsobject[]ボディ

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

Detailed field description
urlstringボディ必須

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 画像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

metadataobjectボディ

Metadata parameters for passing additional configuration options

Supported metadata fields
resolutionstringボディデフォルト: 1K

Output image resolution

Supported values:

  • 1K - 1K resolution (default, only supported option)
orientationstringボディ

Image orientation

Supported values:

  • landscape - Landscape
  • portrait - Portrait

レスポンス

idstring

Unique task identifier for status queries

objectstring

Object type, always generation.task

modelstring

モデル name used

statusstring

Task status

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

Task progress percentage (0-100)

created_atinteger

Task creation timestamp (Unix timestamp)

metadataobject

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": {}
}