Прочтите это в первую очередь: что умеет этот API, а что нет
Если вы попали сюда, размышляя, как использовать API Nano Banana для создания картинок, честный ответ таков: этот сервис не умеет это делать. «Nano Banana» — это имя, которое обычно дают модели генерации изображений, а генерация изображений здесь не предлагается. То, что предлагает nanobananaapis.com, — это доступ к текстовой языковой модели через эндпоинт, совместимый с OpenAI.
Это всё ещё вписывается во многие рабочие процессы с изображениями, потому что инструменты для изображений хороши ровно настолько, насколько хорош текст, который вы им подаете. Текстовая модель может писать промпты, варьировать их, проверять по гайду по стилю, создавать описания и альт-текст, а также разрабатывать скрипты, связывающие конвейер воедино. На этой странице описывается этот вариант использования. Если вам нужны только картинки, вам нужен сервис генерации изображений, который можно связать с этим.
Модель — одна модель с открытыми весами, запускаемая независимым провайдером, настроенная на ответы без отказов по контенту для законного использования взрослыми. Это не официальный API какого-либо крупного вендора. Единственное жесткое ограничение: нет сексуального контента с участием несовершеннолетних.
Шаг 1: получите ключ
Зарегистрируйтесь через Google или по электронной почте и паролю, затем откройте страницу API-ключа. Вы увидите кнопку в один клик для получения $0,50 пробного баланса. Он действителен в течение 7 дней, карта не нужна, и он ограничен одним на человека. Пробный ключ позволяет 2 параллельных запроса и 60 запросов в минуту, чего более чем достаточно для тестирования.
Скопируйте ключ и храните его вне репозитория. В оболочке вы можете сохранить его так:
export NANOBANANA_KEY="paste-your-key-here"
Шаг 2: отправьте свой первый запрос
Важны три значения: базовый URL, идентификатор модели и заголовок Authorization. Всё остальное следует формату chat-completions OpenAI. Вот первый вызов с помощью curl:
curl https://api.nanobananaapis.com/v1/chat/completions -H "Authorization: Bearer $NANOBANANA_KEY" -H "Content-Type: application/json" -d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}
],
"max_tokens": 200
}'
То же самое на Python с официальным пакетом openai:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write one detailed image prompt for a foggy harbor at dawn."}],
)
print(r.choices[0].message.content)
И в Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nanobananaapis.com/v1",
apiKey: process.env.NANOBANANA_KEY,
});
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write one detailed image prompt for a foggy harbor at dawn." }],
});
console.log(r.choices[0].message.content);
Проверьте заголовки ответа один раз. X-Balance-USD показывает ваш оставшийся баланс, а X-Request-Id идентифицирует вызов, если вам понадобится помощь. На странице документации перечислены все поддерживаемые параметры.
Шаг 3: превращение идей в структурированные промпты
Самый полезный трюк для конвейера изображений — заставить модель возвращать структурированные данные вместо свободного текста. JSON-режим делает именно это. Вы описываете схему в системном сообщении, и ответ парсится прямо в ваш код, так что список черновых идей превращается в таблицу промптов с фиксированными полями.
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
SYSTEM = (
"You write prompts for an image model. Reply with JSON only: "
'{"prompts": [{"subject": str, "style": str, "lighting": str, "negative": str, "full": str}]}'
)
def expand(idea: str, n: int = 3):
r = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
temperature=0.9,
messages=[
{"role": "system", "content": SYSTEM},
{"role": "user", "content": f"Give {n} distinct prompts for: {idea}"},
],
)
return json.loads(r.choices[0].message.content)["prompts"]
for p in expand("a lighthouse keeper's kitchen in winter"):
print(p["full"])
Повышайте temperature, когда хотите разнообразия, и понижайте для стабильности. Параметр seed передаётся как есть, поэтому вы можете зафиксировать его, когда нужно воспроизвести предыдущий пакет. Всегда оборачивайте json.loads в блок try и повторяйте запрос один раз при ошибке парсинга, так как любая языковая модель может ошибиться.
На сайте также есть связанное объяснение по части изображений: генерация промптов и постобработка. Оно охватывает, как текстовый этап подключается к генератору.
Другие задачи, которые текстовая модель выполняет хорошо в рабочем процессе с изображениями
- Таблицы стилей. Сохраняйте одно системное сообщение с вашими фиксированными правилами стиля и пропускайте через него каждый новый предмет, чтобы вся серия оставалась визуально согласованной.
- Подписи и альт-текст. После появления изображений описывайте их несколькими словами каждое. Передайте собственное описание изображения на вход; модель не способна видеть изображения, поскольку API принимает только текст.
- Списки кадров и скрипты. Для раскадровки или короткого видео составьте список сцен, озвучку и визуальные акценты в виде текста.
- Критика промптов. Вставьте промпт, который дает плохие результаты, и попросите три переписанных варианта с объяснением изменений.
- Художественная литература и работа с персонажами для взрослых. Листы персонажей, предыстории и диалоги для историй и приложений-компаньонов, при этом модель не избегает законных тем для взрослых.
Для длительных задач используйте потоковую передачу с stream: true, чтобы пользовательский интерфейс мог показывать текст по мере поступления. Также поддерживается вызов функций, что позволяет модели решать, когда вызвать вашу собственную функцию, например, одну, которая отправляет промпт в используемый вами сервис изображений.
Лимиты и стоимость запуска
Знайте цифры, прежде чем создавать пакет. Полный ключ позволяет выполнять 8 параллельных запросов и 300 запросов в минуту. Контекстное окно составляет 100 000 токенов, охватывая промпт и ответ, максимальный размер тела запроса — 8 МБ, а параметр max_tokens необязателен. Превышение лимита запросов возвращает HTTP 429 с кодом rate_limited или concurrency; подождите и повторите попытку.
Цены: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Предположим, вы генерируете 500 наборов промптов, каждый с входом в 400 токенов и выходом в 600 токенов:
- Вход: 500 x 400 = 200 000 токенов x $0,15 / 1 млн = $0,03
- Выход: 500 x 600 = 300 000 токенов x $0,50 / 1 млн = $0,15
- Итого: $0,18
Таким образом, пробного кредита в $0.50 хватит примерно на 1 300 таких наборов. Для регулярного использования пополняйте баланс любой суммой от $20 до $500 криптовалютой (USDT на TRC20, USDC на Base). Бонусы составляют 5% от $50, 10% от $100 и 15% от $200. См. таблицу на странице с ценами. Кредит не сгорает.
Совместное использование с сервисом изображений
Обычная настройка состоит из двух этапов. Текстовый этап использует этот API для создания промптов. Этап изображений отправляет эти промпты в любой генератор изображений, который вы используете, и у этого генератора есть свой аккаунт, свои цены и свои правила, которые следует прочитать на его сайте. Держите два этапа в отдельных функциях, чтобы можно было изменить любую часть, не переписывая другую.
Практический совет: сохраняйте каждый промпт вместе с seed и temperature, которые вы использовали для его создания. Когда изображение получается удачным, вы можете отследить его до точного текста, который его породил, а когда пакет разочаровывает, вы можете понять, в чём была проблема: в идее, в авторе промпта или в модели генерации изображений. Это также даёт вам дешёвый способ сравнить два системных сообщения, запустив оба на одном списке идей и оценив два набора промптов бок о бок.
Небольшой сквозной скрипт
Чтобы связать всё вместе, вот короткий скрипт, который читает файл с черновыми идеями, расширяет каждую из них в промпты в JSON-режиме и записывает результат в файл, который ваш инструмент для изображений может прочитать. Он обрабатывает один сценарий ошибки, который иначе вас подстерегает: ответ, который не является валидным JSON.
import json, os
from openai import OpenAI
client = OpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
)
def one(idea: str):
for _ in range(2):
r = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": 'Reply with JSON only: {"prompt": str}'},
{"role": "user", "content": f"Write a vivid, specific image prompt for: {idea}"},
],
max_tokens=250,
)
try:
return json.loads(r.choices[0].message.content)["prompt"]
except (json.JSONDecodeError, KeyError):
continue
return None
ideas = [line.strip() for line in open("ideas.txt") if line.strip()]
out = {i: one(i) for i in ideas}
json.dump(out, open("prompts.json", "w"), indent=2)
Сначала запустите его на пяти идеях и прочитайте результаты вручную. Настройте системное сообщение, пока промпты не начнут соответствовать желаемому стилю, затем масштабируйте. Поскольку каждый запрос здесь небольшой, тысяча идей обрабатывается быстро и стоит копейки.
Ошибки новичков
- Ожидание картинок. Ответ всегда текстовый. Если ваш код пытается сохранить бинарное изображение из ответа, он потерпит неудачу, потому что его нет.
- Поиск другого имени модели. Есть одна модель, и её идентификатор —
uncensored. Копирование имени модели вендора из руководства приведет к ошибке «не найдено». - Забытое системное сообщение. Без него модель не имеет руководства по стилю и колеблется между короткими и длинными промптами. Поместите туда свои правила.
- Отправка секретов в промптах. Промпты не используются для обучения, но вам всё равно следует избегать вставки паролей или закрытых ключей в любой ввод модели.
- Запуск ста запросов одновременно. Полный ключ позволяет 8 одновременно. Используйте пул или семафор и добавьте повторную попытку для 429.
Если что-то ведет себя странно, страница поддержки — место, где можно задать вопрос, а идентификатор запроса из заголовков ответа значительно упрощает ответ.
