Gemini-2.5-Flash Official 이미지 생성

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-official",
    "prompt": "A cat wearing an astronaut suit walking on the moon",
    "size": "1:1",
    "n": 1,
    "metadata": {
      "temperature": 1.0
    }
  }'

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-official",
        "prompt": "A cat wearing an astronaut suit walking on the moon",
        "size": "1:1",
        "n": 1,
        "metadata": {
            "temperature": 1.0
        }
    }
)

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-official',
    prompt: 'A cat wearing an astronaut suit walking on the moon',
    size: '1:1',
    n: 1,
    metadata: {
      temperature: 1.0
    }
  })
});

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-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-2.5-flash-image-official",
    "prompt": "A cat wearing an astronaut suit walking on the moon",
    "size": "1:1",
    "n": 1,
    "metadata": {
      "temperature": 1.0
    }
  }'

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-official",
        "prompt": "A cat wearing an astronaut suit walking on the moon",
        "size": "1:1",
        "n": 1,
        "metadata": {
            "temperature": 1.0
        }
    }
)

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-official',
    prompt: 'A cat wearing an astronaut suit walking on the moon',
    size: '1:1',
    n: 1,
    metadata: {
      temperature: 1.0
    }
  })
});

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

Direct connection to Google Vertex AI using the Gemini 2.5 Flash Image native API
Select the gemini-2.5-flash-image-official model via the model parameter
Nano Banana official alias: nano-banana-official
Supports text-to-image and image-to-image generation
Supports native generation parameters like temperature, topP, and maxOutputTokens
Supports personGeneration and imageOutputOptions image configuration
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-2.5-flash-image-official"

필수

Image generation model nameExample: "gemini-2.5-flash-image-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 3 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, default 1.0

number

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

integer

Maximum output tokensDefault 32768

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)

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-2.5-flash-image-official",
    "prompt": "A cat wearing an astronaut suit walking on the moon",
    "size": "1:1",
    "n": 1,
    "metadata": {
      "temperature": 1.0
    }
  }'

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-official",
        "prompt": "A cat wearing an astronaut suit walking on the moon",
        "size": "1:1",
        "n": 1,
        "metadata": {
            "temperature": 1.0
        }
    }
)

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-official',
    prompt: 'A cat wearing an astronaut suit walking on the moon',
    size: '1:1',
    n: 1,
    metadata: {
      temperature: 1.0
    }
  })
});

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

개요

빠른 시작

채팅 API

이미지 API

비디오 API

작업 관리

파일 업로드

계정

자주 묻는 질문

Gemini-2.5-Flash Official 이미지 생성

Authorizations

Body

응답

​Authorizations

​Body

​응답

Authorizations

Body

응답