Gemini-3-Pro Official 画像生成

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-official",
    "prompt": "A futuristic city skyline with neon lights, cyberpunk style",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "temperature": 1.0,
      "topP": 0.95,
      "resolution": "2K",
      "personGeneration": "ALLOW_ALL",
      "thinkingConfig": {
        "thinkingLevel": "HIGH"
      }
    }
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-3-pro-image-preview-official",
        "prompt": "A futuristic city skyline with neon lights, cyberpunk style",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "temperature": 1.0,
            "topP": 0.95,
            "resolution": "2K",
            "personGeneration": "ALLOW_ALL",
            "thinkingConfig": {
                "thinkingLevel": "HIGH"
            }
        }
    }
)

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-3-pro-image-preview-official',
    prompt: 'A futuristic city skyline with neon lights, cyberpunk style',
    size: '16:9',
    n: 1,
    metadata: {
      temperature: 1.0,
      topP: 0.95,
      resolution: '2K',
      personGeneration: 'ALLOW_ALL',
      thinkingConfig: {
        thinkingLevel: 'HIGH'
      }
    }
  })
});

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-3-pro-image-preview-official",
  "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-3-pro-image-preview-official",
    "prompt": "A futuristic city skyline with neon lights, cyberpunk style",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "temperature": 1.0,
      "topP": 0.95,
      "resolution": "2K",
      "personGeneration": "ALLOW_ALL",
      "thinkingConfig": {
        "thinkingLevel": "HIGH"
      }
    }
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-3-pro-image-preview-official",
        "prompt": "A futuristic city skyline with neon lights, cyberpunk style",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "temperature": 1.0,
            "topP": 0.95,
            "resolution": "2K",
            "personGeneration": "ALLOW_ALL",
            "thinkingConfig": {
                "thinkingLevel": "HIGH"
            }
        }
    }
)

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-3-pro-image-preview-official',
    prompt: 'A futuristic city skyline with neon lights, cyberpunk style',
    size: '16:9',
    n: 1,
    metadata: {
      temperature: 1.0,
      topP: 0.95,
      resolution: '2K',
      personGeneration: 'ALLOW_ALL',
      thinkingConfig: {
        thinkingLevel: 'HIGH'
      }
    }
  })
});

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-3-pro-image-preview-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

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

Direct connection to Google Vertex AI using the Gemini 3 Pro Image native API
Select the gemini-3-pro-image-preview-official model via the model parameter
Nano Banana Pro alias: nano-banana-pro-official
Supports text-to-image and image-to-image generation
Supports native generation parameters like temperature, topP, and maxOutputTokens
Supports resolution (1K/2K/4K), personGeneration, and imageOutputOptions image configuration
Supports thinkingConfig thinking mode for improved complex scene generation
Supports safetySettings for content safety control
Asynchronous task management with task ID for result querying

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 endpoint to upload images first, then use the returned URL in this API.

Authorizations

string

必須

All endpoints require Bearer Token authenticationGet API Key: Visit the API Key Management page to obtain your API KeyAdd to request headers:

Authorization: Bearer YOUR_API_KEY

Body

string

デフォルト:"gemini-3-pro-image-preview-official"

必須

Image generation model nameExample: "gemini-3-pro-image-preview-official"

string

必須

Text description for image generation

string

Image aspect ratioSupported formats:

1:1 - Square
3:2 / 2:3
3:4 / 4:3
4:5 / 5:4
9:16 / 16:9
21:9

integer

デフォルト:1

Number of images to generateFixed at 1

string[]

Reference image URL array for image-to-image generation or editing⚠️ Only URL format is supported (base64 is no longer supported)

Publicly accessible image URLs (http:// or https://)
Use the Upload Image endpoint to upload local images and get URLs

Limits:

Maximum 14 images
Maximum file size per image: 10MB
Supported formats: .jpeg, .jpg, .png, .webp

object

Vertex AI native extension parameters

表示 Show metadata fields

number

Generation temperature, controls output randomnessRange: 0.0 - 2.0

number

Top-P sampling parameterRange: 0.0 - 1.0, default 0.95

integer

Maximum output tokensDefault 32768

string

Output image resolution, automatically mapped to Vertex AI native imageSizeOptions: 1K, 2K, 4K, default 1K

string

Person generation controlOptions:

ALLOW_ALL - Allow generating all people (including adults and children)
ALLOW_ADULT - Allow generating adults only
ALLOW_NONE - Disallow generating people

object

Image output format configuration

表示 imageOutputOptions fields

string

Output image formatOptions: image/png, image/jpeg, image/webp

integer

Compression quality (JPEG only)

object

Thinking mode configuration. When enabled, the model reasons before generating images, improving results for complex scenes

表示 thinkingConfig fields

integer

Thinking token budget, controls the depth of model reasoningRange: 0 - 24576, default is determined by the model

string

Thinking levelOptions: LOW, MEDIUM, HIGH, MINIMAL

array

Safety settings array for content safety filtering

表示 safetySettings elements

string

Safety categoryOptions: HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_HARASSMENT

string

Filtering thresholdOptions: OFF, BLOCK_LOW_AND_ABOVE, BLOCK_MEDIUM_AND_ABOVE, BLOCK_ONLY_HIGH

レスポンス

string

Unique task identifier for querying task status

string

Object type, always generation.task

string

モデル 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-3-pro-image-preview-official",
    "prompt": "A futuristic city skyline with neon lights, cyberpunk style",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "temperature": 1.0,
      "topP": 0.95,
      "resolution": "2K",
      "personGeneration": "ALLOW_ALL",
      "thinkingConfig": {
        "thinkingLevel": "HIGH"
      }
    }
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-3-pro-image-preview-official",
        "prompt": "A futuristic city skyline with neon lights, cyberpunk style",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "temperature": 1.0,
            "topP": 0.95,
            "resolution": "2K",
            "personGeneration": "ALLOW_ALL",
            "thinkingConfig": {
                "thinkingLevel": "HIGH"
            }
        }
    }
)

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-3-pro-image-preview-official',
    prompt: 'A futuristic city skyline with neon lights, cyberpunk style',
    size: '16:9',
    n: 1,
    metadata: {
      temperature: 1.0,
      topP: 0.95,
      resolution: '2K',
      personGeneration: 'ALLOW_ALL',
      thinkingConfig: {
        thinkingLevel: 'HIGH'
      }
    }
  })
});

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-3-pro-image-preview-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

概要

クイックスタート

モデル一覧

チャットAPI

画像API

動画API

音楽API

タスク管理

ファイルアップロード

アカウント

よくある質問

Authorizations

Body

レスポンス

​Authorizations

​Body

​レスポンス

Authorizations

Body

レスポンス