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": "Кот в скафандре на Луне",
"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": "Превратить этого кота в мультяшный стиль",
"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": "Кот в скафандре на Луне",
"size": "1:1",
"n": 1
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {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": "Превратить этого кота в мультяшный стиль",
"size": "1:1",
"n": 1,
"image_urls": ["https://example.com/cat.jpg"]
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {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: 'Кот в скафандре на Луне',
size: '1:1',
n: 1
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${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: 'Превратить этого кота в мультяшный стиль',
size: '1:1',
n: 1,
image_urls: ['https://example.com/cat.jpg']
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gemini-2.5-flash-image-preview",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}
Gemini-2.5-Flash-Image-preview (Nano banana)
Gemini-2.5-Flash Генерация изображений
Быстрая генерация изображений с помощью модели Google Gemini 2.5 Flash
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-preview",
"prompt": "Кот в скафандре на Луне",
"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": "Превратить этого кота в мультяшный стиль",
"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": "Кот в скафандре на Луне",
"size": "1:1",
"n": 1
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {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": "Превратить этого кота в мультяшный стиль",
"size": "1:1",
"n": 1,
"image_urls": ["https://example.com/cat.jpg"]
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {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: 'Кот в скафандре на Луне',
size: '1:1',
n: 1
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${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: 'Превратить этого кота в мультяшный стиль',
size: '1:1',
n: 1,
image_urls: ['https://example.com/cat.jpg']
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gemini-2.5-flash-image-preview",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}
Для пользователей из материкового Китая: используйте
https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.- Эффективная модель генерации изображений Google Gemini 2.5 Flash (Nano banana)
- Используйте параметр model для выбора
gemini-2.5-flash-image-preview - Поддержка текст-в-изображение
- Асинхронное управление задачами, запрос результатов по ID задачи
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в
image_urls. Пожалуйста, сначала используйте API загрузки изображений для загрузки изображений и получения URL, а затем вызывайте этот эндпоинт.Авторизация
string
обязательно
Все API требуют аутентификации Bearer TokenПолучите API Key на странице управления API ключами
Тело запроса
string
по умолчанию:"gemini-2.5-flash-image-preview"
обязательно
Название моделиПсевдоним:
nano-bananastring
обязательно
Текстовое описание для генерации
string
Соотношение сторон:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3integer
по умолчанию:1
Количество генерируемых изображенийФиксировано на 1⚠️ Примечание: Должно быть чистым числом (например,
1), не добавляйте кавычки, иначе возникнет ошибкаobject[]
Список URL-адресов эталонных изображений для изображения-в-изображение или редактирования изображений
Ограничение: Максимум 14 изображений
Показать Подробное описание поля
Показать Подробное описание поля
string
обязательно
URL-адрес изображения⚠️ Только формат URL (base64 больше не поддерживается)
- Публично доступный URL изображения (http:// или https://)
- Пример:
https://example.com/image.jpg - Вы можете использовать API загрузки изображений для загрузки локальных изображений и получения URL
- Одно изображение не должно превышать 10 МБ
- Поддерживаемые форматы: .jpeg, .jpg, .png, .webp
object
Параметры метаданных для передачи дополнительных параметров конфигурации
Ответ
string
Уникальный идентификатор задачи для запроса статуса
string
Тип объекта, всегда
generation.taskstring
Используемое имя модели
string
Статус задачи
queued- В очереди на обработкуin_progress- Обработкаcompleted- Успешно завершеноfailed- Не удалось
integer
Процент выполнения задачи (0-100)
integer
Временная метка создания задачи (временная метка Unix)
object
Метаданные задачи
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": "Кот в скафандре на Луне",
"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": "Превратить этого кота в мультяшный стиль",
"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": "Кот в скафандре на Луне",
"size": "1:1",
"n": 1
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {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": "Превратить этого кота в мультяшный стиль",
"size": "1:1",
"n": 1,
"image_urls": ["https://example.com/cat.jpg"]
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {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: 'Кот в скафандре на Луне',
size: '1:1',
n: 1
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${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: 'Превратить этого кота в мультяшный стиль',
size: '1:1',
n: 1,
image_urls: ['https://example.com/cat.jpg']
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "gemini-2.5-flash-image-preview",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}