RU ▾

API текста без цензуры для вашего конвейера

Как использовать API Nano Banana с текстовой LLM в рабочих процессах

Этот сайт не генерирует изображения. Это текстовый API LLM, совместимый с OpenAI, который используют вместе с инструментами для изображений для написания промптов, описаний и скриптов. Вот как его настроить и использовать.

Обновлено

Изометрическая иллюстрация текстовых карточек, летящих к пустой рамке, показывающая, как промпты питают рабочий процесс с изображениями

Ключевые моменты

  • API возвращает только текст: генерации изображений, аудио или видео нет.
  • Используйте базовый URL https://api.nanobananaapis.com/v1, идентификатор модели uncensored и ключ Bearer.
  • Распространённое использование — превращение черновых идей в структурированные промпты для изображений в JSON-режиме.
  • Ввод стоит $0.15, а вывод — $0.50 за 1 млн токенов, неудачные запросы бесплатны.

Прочтите это в первую очередь: что умеет этот 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.

Если что-то ведет себя странно, страница поддержки — место, где можно задать вопрос, а идентификатор запроса из заголовков ответа значительно упрощает ответ.

Вопросы и ответы

Может ли этот API генерировать изображения Nano Banana?

Нет. Это текстовый API LLM. Он может писать промпты, описания и скрипты для рабочих процессов с изображениями, но не генерирует изображения, аудио или видео.

Какое имя модели указать?

Используйте uncensored как ID модели, с базовым URL https://api.nanobananaapis.com/v1 и вашим ключом в качестве токена Bearer.

Могу ли я протестировать его без оплаты?

Да. Новые пользователи могут получить $0,50 пробного баланса в один клик на странице API-ключа. Для этого не нужна карта, а средства действительны в течение 7 дней.

Видит ли модель мои изображения?

Нет. Она обрабатывает только текст. Если вам нужна помощь с изображением, опишите его в своём сообщении.

Используются ли мои промпты для обучения?

Нет. Промпты не используются для обучения.

Ваш ключ — в одной форме от вас

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.

Получить API-ключ