Начало работы с Nano Banana Pro API

Nano Banana Pro API — это практичный, готовый к использованию в продакшене интерфейс для генерации изображений с помощью новейших моделей на базе Gemini. Это руководство по Nano Banana Pro API фокусируется на реальном использовании: как создавать промпты, структурировать запросы, интерпретировать ответы и выстраивать рабочий процесс, на который может положиться ваш продукт.

Если вам нужен официальный обзор, демо и контекст продукта Nano Banana 2, начните с хаба Nano Banana 2.

Что такое Nano Banana Pro API?

Nano Banana Pro API предоставляет вам простой REST-интерфейс для генерации высококачественных изображений. Вы отправляете промпт и необязательные референсы, а получаете изображения, которые можете хранить и доставлять в своем приложении. Он разработан для команд, которым нужны стабильные результаты, повторяемые рабочие процессы и предсказуемые паттерны интеграции.

Когда использовать Nano Banana Pro API

Используйте Nano Banana Pro API, когда вам нужны быстрые визуальные эффекты по требованию без создания собственной конвейерной модели:

• Маркетинговый контент для рекламы и целевых страниц
• Изображения продуктов для каталогов и списков электронной коммерции
• Креативные черновики для ранних концепций и мудбордов

Основные возможности

API построен вокруг нескольких ключевых преимуществ, важных в продакшене:

• Генерация текста в изображение для превращения естественного языка в визуальные образы
• Создание изображения из изображения для ремикширования или создания на основе существующих снимков
• Вывод с учетом референсов для сохранения единого стиля и объекта
• Масштабируемая производительность для обеспечения пакетных заданий и автоматизированных рабочих процессов

Быстрый старт с Nano Banana Pro API

1. Получите доступ

Создайте учетную запись в панели управления EvoLink, затем сгенерируйте API-ключ для вашего проекта. Храните ключ в безопасном хранилище секретов и никогда не раскрывайте его в клиентском коде.

2. Сделайте первый запрос

Вот минимальный пример cURL. Замените заполнители вашими реальными значениями.

curl -X POST "API_BASE/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "A beautiful sunset over mountains, digital art style",
    "size": "ASPECT_RATIO",
    "quality": "RESOLUTION_TIER"
  }'

3. Обработка ответа

Ответ обычно включает метаданные и список URL-адресов или идентификаторов изображений. Быстро сохраняйте результаты и помещайте их в собственный слой хранения для долгосрочного доступа.

{
  "created": 1737014400,
  "data": [
    {
      "url": "IMAGE_URL"
    }
  ]
}

Основные параметры, которые нужно знать

Это параметры, которые вы будете использовать чаще всего при вызове Nano Banana Pro API:

• model: Используйте модель, включенную для вашей учетной записи. Выберите экономичный уровень для черновиков и премиум-уровень для финальных ассетов.
• prompt: Текст вашей инструкции. Будьте точны в отношении объекта, стиля и настроения.
• size: Соотношение сторон или предустановка размера, которая подходит для вашего размещения (квадрат, портрет или пейзаж).
• quality: Уровень разрешения, необходимый для финального вывода.
• image_urls: Необязательные референсные изображения, если вы хотите сохранить единообразие объекта или стиля.

Асинхронные задания и URL изображений

Многие команды запускают API асинхронно: отправляют задание, опрашивают задачу до завершения, затем скачивают и сохраняют изображение. URL могут быть ограничены по времени, поэтому относитесь к ним как к временным и перемещайте их в собственное хранилище, как только они будут готовы.

Плейбук по промптам

Самый быстрый способ улучшить результаты — использовать четкую структуру промпта. Хорошо работает простая формула:

Объект + Контекст + Стиль + Освещение + Композиция + Качество

Вот еще несколько практических советов по промптам:

1. Будьте конкретны — Назовите объект и опишите ключевые детали.
2. Определите стиль — Фотореалистичный, акварель, кинематографичный, редакционный.
3. Контролируйте композицию — Крупный план, общий план, вид сверху или по центру.

Примеры промптов

Контроль качества и итерация

Относитесь к генерации как к быстрому циклу дизайна. Начните с широкого промпта, затем итерируйте:

• Добавляйте или удаляйте детали на основе первого вывода.
• Зафиксируйте стиль перед уточнением объекта.
• Сохраняйте лучшие промпты, чтобы ваша команда могла повторно использовать их позже.
• Используйте референсные изображения, когда важна согласованность в серии.

Чек-лист для продакшена

Используйте этот чек-лист перед запуском Nano Banana Pro API в вашем рабочем процессе:

• API-ключ хранится в безопасном хранилище секретов на стороне сервера
• Базовые промпты задокументированы для ваших основных вариантов использования
• Выходные изображения сохранены в постоянном хранилище

Итог

Nano Banana Pro API — это надежный способ создания высококачественных визуальных эффектов с чистым REST-интерфейсом. Начните с четких промптов, быстро итерируйте и документируйте свои лучшие результаты. Для команд, которые быстро выпускают продукты, это поддерживает творческий поток без тяжелых инструментов.