Полное руководство по документации Nano Banana 2: сравнение двух решений — официальный API и интеграция через APIYI

Примечание автора: Подробный разбор документации Nano Banana 2 (gemini-3.1-flash-image-preview). Сравниваем два варианта подключения: официальный API Google и платформу APIYI. Внутри — полные примеры кода, конфигурация параметров и стратегии экономии.

Разработчикам, которые хотят внедрить Nano Banana 2, сейчас доступны два основных источника: официальная документация Google (ai.google.dev/gemini-api/docs/image-generation) и документация платформы APIYI (docs.apiyi.com/api-capabilities/nano-banana-2-image).

У каждого решения свои плюсы: официальный API дает полный доступ ко всем фишкам, а через APIYI подключиться проще всего, при этом цена начинается всего от $0.03 за запрос. В этой статье я собрал и сравнил ключевые моменты из обоих документов, чтобы вы могли выбрать лучший путь.

В чем польза: после прочтения вы разберетесь в параметрах API Nano Banana 2, увидите примеры кода для обоих вариантов и поймете, какой из них выгоднее для ваших задач.

Краткий справочник основных параметров Nano Banana 2

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

14 поддерживаемых соотношений сторон в Nano Banana 2

🎯 Совет для разработчиков: Соотношения 1:4, 4:1, 1:8 и 8:1 — это эксклюзивные форматы Nano Banana 2, Nano Banana Pro их не поддерживает. Если вашему приложению нужны сверхдлинные баннеры или инфографика, используйте только gemini-3.1-flash-image-preview.

Вариант интеграции Nano Banana 2 А: Официальный Google API

Базовый вызов официального API

Официальный API использует Google Gen AI SDK, который поддерживает Python, JavaScript, Go, Java и REST.

from google import genai
from google.genai import types

client = genai.Client()

# Базовая генерация текст-в-изображение
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Рыжий кот кувыркается в осенней листве, теплые тона",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE']
    )
)

# Извлечение сгенерированного изображения
for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)

from google import genai
from google.genai import types

client = genai.Client()

# Полная конфигурация: разрешение 2K + формат 16:9 + режим глубоких рассуждений (High)
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Обложка годового отчета технологической компании, заголовок 'AI Vision 2026', темно-синие тона, минимализм",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        ),
        thinking_config=types.ThinkingConfig(
            thinking_level="High",
            include_thoughts=True
        )
    )
)

# Разбор ответа (включая процесс рассуждения Thinking)
for part in response.parts:
    if part.thought and part.text:
        print(f"[Процесс рассуждения] {part.text}")
    elif part.inline_data:
        with open("report_cover.png", "wb") as f:
            f.write(part.inline_data.data)
        print("Изображение сохранено")

Генерация с использованием Image Search через официальный API

Это эксклюзивная возможность Nano Banana 2 — поиск в Google Картинках перед генерацией для получения актуальных визуальных референсов:

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Новейшая модель Tesla Model Y 2026 года, серебристая, припаркована на городской улице",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        tools=[
            types.Tool(google_search=types.GoogleSearch(
                search_types=types.SearchTypes(
                    web_search=types.WebSearch(),
                    image_search=types.ImageSearch()
                )
            ))
        ]
    )
)

🎯 Внимание: При использовании Image Search есть требование к отображению — необходимо предоставить кликабельную ссылку на веб-страницу первоисточника изображения. Токены за рассуждения (Thinking tokens) тарифицируются независимо от того, включен ли возврат процесса рассуждения в ответе.

Вариант интеграции Nano Banana 2 Б: платформа APIYI

Преимущества платформы APIYI

Вызов в формате, совместимом с OpenAI через APIYI

Если у вас уже есть код, использующий OpenAI SDK, для перехода на Nano Banana 2 достаточно изменить всего две строки:

import openai

client = openai.OpenAI(
    api_key="YOUR_APIYI_KEY",
    base_url="https://vip.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[{"role": "user", "content": "Картина в стиле гохуа (тушь), композиция с использованием пустого пространства, далекие горы в тумане"}]
)

import requests
import base64

API_KEY = "YOUR_APIYI_KEY"

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "contents": [{"parts": [{"text": "Рекламный постер для e-commerce, крупный заголовок 'Весенняя распродажа', красная цветовая гамма"}]}],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {
                "aspectRatio": "9:16",
                "imageSize": "2K"
            }
        }
    },
    timeout=300
).json()

# Декодируем и сохраняем изображение
img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("poster.png", "wb") as f:
    f.write(base64.b64decode(img_data))
print("Изображение успешно сгенерировано, стоимость около $0.03")

Совет: Зарегистрируйтесь на сайте APIYI apiyi.com, чтобы получить API-ключ и начать работу. Платформа поддерживает как формат OpenAI, так и нативный формат Google, а один ключ открывает доступ ко всем доступным моделям.

Сравнение цен на два варианта Nano Banana 2

Сравнение ежемесячных затрат на Nano Banana 2 (1000 изображений в день)

Цена $0.03 за запрос в APIYI не только на 55% ниже стандартной официальной цены, но и даже меньше, чем официальная цена Batch со скидкой 50% ($0.034). При этом вы получаете результат в реальном времени, не дожидаясь 24-часовой асинхронной обработки.

🎯 Выгодное решение: вызывая Nano Banana 2 через APIYI (apiyi.com), 1000 изображений в день обойдутся вам всего в $30, а месячные затраты составят $900. При регистрации начисляется бесплатный тестовый баланс, а один API-ключ открывает доступ к Nano Banana 2, Pro и другим популярным моделям.

Руководство по продвинутым функциям Nano Banana 2

Многоэтапное редактирование изображений в диалоге

Nano Banana 2 поддерживает последовательное изменение одного и того же изображения в рамках диалога:

# Многоэтапное редактирование в формате APIYI + OpenAI
messages = [
    {"role": "user", "content": "Создай минималистичный логотип бренда в синих тонах"},
    # После получения результата первого этапа продолжаем редактирование
    {"role": "assistant", "content": "[Результат первой генерации]"},
    {"role": "user", "content": "Измени цвет на градиентный фиолетовый и добавь название компании 'TechFlow'"}
]

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=messages
)

Генерация с эталонными изображениями в Nano Banana 2

Выбор режима Thinking в Nano Banana 2

🎯 Совет для разработчиков: За Thinking-токены взимается плата независимо от того, установлено ли includeThoughts=true. Если вам не нужно просматривать процесс рассуждения, оставьте значение false по умолчанию — это не повлияет на качество генерации, просто модель не будет возвращать текст промежуточных рассуждений.

Справочник скорости генерации Nano Banana 2

Совет: При вызове Nano Banana 2 рекомендуем устанавливать timeout=300 (300 секунд), чтобы избежать ошибок по таймауту из-за нестабильности сети или колебаний вычислительных мощностей Google. Использование APIYI (apiyi.com) обеспечит более стабильное соединение.

Часто задаваемые вопросы

Итоги

Ключевые моменты документации по разработке с Nano Banana 2:

1. У каждого из двух решений свои преимущества: официальный API от Google предлагает самый полный функционал (Image Search, Thinking, 14 эталонных изображений), а APIYI — самую низкую цену ($0.03 за вызов) и максимально простое подключение.
2. APIYI ($0.03) — это всего 45% от официальной цены: вы получаете мгновенный ответ, что даже дешевле официального тарифа Batch ($0.034), и при этом не нужно ждать 24 часа.
3. Основные параметры универсальны: 4 варианта разрешения, 14 соотношений сторон, режим Thinking и другие параметры идентичны в обоих вариантах.

Для большинства разработчиков мы рекомендуем использовать APIYI (apiyi.com) для быстрого доступа к Nano Banana 2. Цена $0.03 за генерацию, формат, совместимый с OpenAI, и бесплатные бонусы при регистрации позволят вам создать первое изображение уже через 5 минут.

📚 Справочные материалы

1. Официальная документация Google Gemini по генерации изображений: Полный справочник API Nano Banana 2

   • Ссылка: ai.google.dev/gemini-api/docs/image-generation
   • Описание: Официальная документация по всем параметрам, функциям и продвинутым возможностям.

2. Документация APIYI по Nano Banana 2: Быстрое подключение и примеры кода

   • Ссылка: docs.apiyi.com/api-capabilities/nano-banana-2-image
   • Описание: Руководство по интеграции на платформе APIYI, включая тарифы и примеры вызовов.

3. Официальные тарифы Gemini API: Точные цены для каждого разрешения

   • Ссылка: ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview
   • Описание: Стандартные цены и тарифы Batch для разрешений 0.5K/1K/2K/4K.

4. Лимиты частоты запросов Gemini API: Ограничения для моделей Preview

   • Ссылка: ai.google.dev/gemini-api/docs/rate-limits
   • Описание: Информация о квотах и лимитах для моделей версии Preview.

Автор: Техническая команда APIYI
Обмен опытом: Делитесь своим опытом разработки на Nano Banana 2 в комментариях. Больше материалов по моделям ИИ можно найти в центре документации APIYI: docs.apiyi.com