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": {}
}
Gemini-2.5-Flash-Image Official
Gemini-2.5-Flash Official 画像生成
Generate images using Google Gemini 2.5 Flash official direct-connect model, fast and efficient
POST
/
v1
/
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": {}
}
中国本土のユーザー向け： 中国本土のユーザーは
https://toapis.cn を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。- Direct connection to Google Vertex AI using the Gemini 2.5 Flash Image native API
- Select the
gemini-2.5-flash-image-officialmodel 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- Square3:2/2:33:4/4:34:5/5:49:16/16:921: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
- Maximum 3 images
- Maximum file size per image: 10MB
- Supported formats: .jpeg, .jpg, .png, .webp
object
Vertex AI native extension parameters
表示 Show metadata fields
表示 Show metadata fields
number
Generation temperature, controls output randomnessRange:
0.0 - 2.0, default 1.0number
Top-P sampling parameterRange:
0.0 - 1.0, default 0.95integer
Maximum output tokensDefault
32768string
Person generation controlOptions:
ALLOW_ALL- Allow generating all people (including adults and children)ALLOW_ADULT- Allow generating adults onlyALLOW_NONE- Disallow generating people
object
array
Safety settings array for content safety filtering
レスポンス
string
Unique task identifier for querying task status
string
Object type, always
generation.taskstring
モデル name used
string
Task status
queued- Queued for processingin_progress- Processingcompleted- Successfully completedfailed- 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": {}
}