Gemini-3.1-Flash 画像生成
Generate images using Google Gemini 3.1 Flash model with extreme aspect ratios and Google Search enhancement
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
- Google Gemini 3.1 Flash image generation model
- Use model parameter to select
gemini-3.1-flash-image-previewmodel - Supports text-to-image and image-to-image, up to 4K resolution output
- Up to 6 reference images to maintain style/character consistency
- Supports extreme aspect ratios (1:4, 4:1, 1:8, 8:1)
- Integrated Google Search enhancement for more accurate real-world images
- 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_KEYBody
modelstringボディ必須デフォルト: gemini-3.1-flash-image-previewImage generation model name
Example: "gemini-3.1-flash-image-preview"
promptstringボディ必須Text description for image generation
sizestringボディImage aspect ratio
Supported ratios:
| Value | Use Case |
|---|---|
1:1 | Square, avatar, social media |
3:2 / 2:3 | Standard photo |
4:3 / 3:4 | Traditional display ratio |
16:9 / 9:16 | Widescreen / vertical video cover |
5:4 / 4:5 | Instagram images |
21:9 | Ultra-wide banner |
1:4 / 4:1 | Long poster / banner |
1:8 / 8:1 | Extreme long image / ad banner |
nintegerボディデフォルト: 1Number of images to generate
⚠️ 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 6 images
metadataobjectボディMetadata parameters for passing additional configuration options
Supported metadata fields
resolutionstringボディデフォルト: 1KOutput image resolution
Supported values:
0.5K- ~512px, low-resolution preview1K- ~1024px, standard resolution (default)2K- ~2048px, high resolution4K- ~4096px, ultra-high resolution
Note: Pricing varies by resolution; 4K costs more than 1K
google_searchbooleanボディデフォルト: falseEnable Google text search enhancement
true: The model will first search the web for text information to assist in image generation, suitable for scenarios requiring real-world accuracyfalse: Disabled (default)
google_image_searchbooleanボディデフォルト: falseEnable Google image search enhancement
true: In addition to text search, also searches for reference images to assist generation, suitable for scenarios requiring visual referencesfalse: Disabled (default)
Note: Must be used together with google_search: true
レスポンス
idstringUnique task identifier for status queries
objectstringObject type, always generation.task
modelstringモデル name used
statusstringTask status
queued- Queued for processingin_progress- Processingcompleted- Successfully completedfailed- Failed
progressintegerTask progress percentage (0-100)
created_atintegerTask creation timestamp (Unix timestamp)
metadataobjectTask metadata
リクエスト例
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.1-flash-image-preview",
"prompt": "A cyberpunk city at night with flickering neon lights",
"size": "16:9",
"n": 1,
"metadata": {
"resolution": "2K"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.1-flash-image-preview",
"prompt": "Transform this photo into a watercolor painting style",
"size": "1:1",
"n": 1,
"image_urls": ["https://example.com/photo.jpg"],
"metadata": {
"resolution": "2K"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.1-flash-image-preview",
"prompt": "Latest iPhone product promotional image",
"size": "16:9",
"n": 1,
"metadata": {
"resolution": "2K",
"google_search": true,
"google_image_search": true
}
}'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.1-flash-image-preview",
"prompt": "A cyberpunk city at night with flickering neon lights",
"size": "16:9",
"n": 1,
"metadata": {
"resolution": "2K"
}
}
)
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-3.1-flash-image-preview",
"prompt": "Transform this photo into a watercolor painting style",
"size": "1:1",
"n": 1,
"image_urls": ["https://example.com/photo.jpg"],
"metadata": {
"resolution": "2K"
}
}
)
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.1-flash-image-preview',
prompt: 'A cyberpunk city at night with flickering neon lights',
size: '16:9',
n: 1,
metadata: {
resolution: '2K'
}
})
});
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-3.1-flash-image-preview',
prompt: 'Transform this photo into a watercolor painting style',
size: '1:1',
n: 1,
image_urls: ['https://example.com/photo.jpg'],
metadata: {
resolution: '2K'
}
})
});
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.1-flash-image-preview",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}