Генерирует и редактирует изображения по текстовому описанию - можно создавать картинку с нуля или менять загруженные фото. Режимы: VIP — 16 ₽, Обычный — 10 ₽, Дешёвый — 5 ₽.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Nano Banana Pro создаёт изображения по текстовому описанию и редактирует одно или несколько изображений по ссылкам.
Основные сценарии:
image_urls.Каждый вызов создаёт асинхронную операцию. После запуска нужно отдельно проверять статус по id.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус операции.Режим работы определяется параметром mode:
normal - обычный режим.vip - приоритетный режим.cheap - дешёвый режим.{
"tool": "nano-banana-pro",
"input": {
"...": "..."
}
}
tool - slug нейросети, всегда "nano-banana-pro".input - параметры запуска. Все поля передаются напрямую внутри этого объекта.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
mode | enum | Да | Режим работы. Варианты: normal, vip, cheap. |
prompt | string | Да | Текстовое описание результата или правки изображения. От 3 до 20 000 символов. |
image_urls | string[] (url) | Нет | Массив внешних URL изображений для редактирования. Можно передать от 1 до 14 ссылок. Если поле не передано или массив пустой, запускается генерация без входных изображений. |
aspect_ratio | enum | Да | Соотношение сторон результата. Варианты: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4, 4:5. |
image_size | enum | Да | Разрешение результата. Варианты: 1K, 2K, 4K. |
Для image_urls разрешены только внешние http/https URL. Поддерживаются jpg, jpeg, png, webp. Форматы heic/heif, которые работают при загрузке файлов через UI, в Public API по URL не поддерживаются.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "nano-banana-pro",
"input": {
"mode": "cheap",
"prompt": "Минималистичный зелёный треугольник на белом фоне",
"aspect_ratio": "1:1",
"image_size": "1K"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'nano-banana-pro',
input: {
mode: 'cheap',
prompt: 'Минималистичный зелёный треугольник на белом фоне',
aspect_ratio: '1:1',
image_size: '1K',
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'nano-banana-pro',
'input': {
'mode': 'cheap',
'prompt': 'Минималистичный зелёный треугольник на белом фоне',
'aspect_ratio': '1:1',
'image_size': '1K',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "nano-banana-pro",
"input": {
"mode": "cheap",
"prompt": "Сделай это фото похожим на мягкую студийную иллюстрацию",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/source-image-2.jpg"
],
"aspect_ratio": "auto",
"image_size": "1K"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'nano-banana-pro',
input: {
mode: 'cheap',
prompt: 'Сделай это фото похожим на мягкую студийную иллюстрацию',
image_urls: [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/source-image-2.jpg',
],
aspect_ratio: 'auto',
image_size: '1K',
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'nano-banana-pro',
'input': {
'mode': 'cheap',
'prompt': 'Сделай это фото похожим на мягкую студийную иллюстрацию',
'image_urls': [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/source-image-2.jpg',
],
'aspect_ratio': 'auto',
'image_size': '1K',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "nano-banana-pro",
"cost": 5,
"balance_after": 495,
"created_at": "2026-03-13T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "nano-banana-pro",
"cost": 5,
"created_at": "2026-03-13T12:00:00Z",
"completed_at": "2026-03-13T12:00:24Z",
"result": {
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/nano-banana-pro/image-1.jpg"
]
},
"error_message": null
}
После создания операции сохраните id и проверяйте её статус запросом:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
После завершения Nano Banana Pro возвращает:
{
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/nano-banana-pro/image-1.jpg"
]
}
type - всегда "image".urls - массив ссылок на готовые изображения.Цена зависит от mode:
| Режим | Цена |
|---|---|
normal | 10 ₽ |
vip | 16 ₽ |
cheap | 5 ₽ |
image_urls не передан или передан как пустой массив, будет выполнена генерация без входных изображений.image_urls разрешены только внешние http/https URL с расширениями jpg, jpeg, png, webp.POST /api/v1/operations не идемпотентен: повторный запрос создаёт новую операцию.queued, затем проверяете статус по id.