Полное руководство по вызову Nano Banana Pro API: на 44% дешевле KIE.ai, быстрая интеграция в нативном формате Google

Примечание автора: Подробный разбор метода вызова Nano Banana Pro API с использованием нативного формата Google Gemini. Через платформу APIYI стоимость составляет всего $0,05 за запрос, что на 44% дешевле, чем на KIE.ai. Поддерживается генерация изображений в разрешении 1K/2K/4K.

Когда нужно вызвать Nano Banana Pro API, многие разработчики первым делом выбирают KIE.ai, но на самом деле существует более выгодный и стабильный вариант. В этой статье я расскажу, как использовать нативный формат Google Gemini API для работы с Nano Banana Pro и как через платформу APIYI снизить стоимость одного вызова до $0,05 — это на 44% дешевле, чем на KIE.ai.

Основная ценность: Прочитав этот материал, вы освоите стандартный способ вызова Nano Banana Pro API, разберетесь в разнице цен между платформами и сможете генерировать изображения профессионального уровня в 4K с минимальными затратами.

Обзор ключевых параметров Nano Banana Pro API

Почему Nano Banana Pro использует нативный формат Google?

Nano Banana Pro (модель gemini-3-pro-image-preview) — это профессиональная модель генерации изображений от Google DeepMind. Дизайн её API основан на нативном протоколе Gemini, который принципиально отличается от формата OpenAI:

• Параметр модальности: необходимо объявлять responseModalities: ["IMAGE"] в объекте generationConfig, а не использовать response_format, как в OpenAI.
• Контроль разрешения: разрешение 1K/2K/4K задается через специальное поле resolution, а не через точные размеры в пикселях.
• Соотношение сторон: используется строковое значение aspectRatio (например, "16:9"), а не числовые параметры ширины и высоты.

Если вы попробуете вызвать модель через SDK в формате OpenAI, вы столкнетесь с ошибкой парсинга параметров. Правильный подход — использовать Google Generative AI SDK или отправлять прямые HTTP-запросы на совместимые эндпоинты.

Что может создавать Nano Banana Pro?

Эта модель демонстрирует выдающиеся результаты в следующих сценариях, значительно опережая конкурентов:

• Рендеринг многоязычного текста: точное встраивание текста на китайском, английском, японском и других языках прямо в изображение. Шрифты четкие, без «галлюцинаций» и артефактов.
• Инфографика и визуализация данных: создание профессиональных инфографик с графиками, таблицами и текстовыми пояснениями.
• Маркетинговые материалы: постеры, изображения товаров, рекламные баннеры с точной типографикой.
• Демонстрация продуктов: реалистичное физическое освещение, детализация текстур и корректные тени.
• Иллюстрации для презентаций: создание слайдов и вставок, соответствующих профессиональной эстетике.

Сравнение цен на Nano Banana Pro API на разных платформах

Прежде чем выбирать платформу для интеграции, стоит разобраться в реальной разнице в затратах:

💰 Сравнение затрат: Если генерировать по 100 изображений в 4K ежедневно, официальный Google обойдется примерно в $720 в месяц, KIE.ai — около $360, а через APIYI (apiyi.com) — всего $150. Экономия составляет более $570 в месяц.

Ключевые преимущества APIYI по сравнению с KIE.ai:

1. Цена ниже: $0.05 за запрос против $0.09 у KIE.ai — экономия 44%.
2. Совместимость форматов: прямая поддержка нативного формата Google Gemini API, никакой возни с конвертацией.
3. Скорость работы: оптимизированные каналы связи обеспечивают более стабильный отклик.
4. Единый интерфейс: поддержка GPT, Claude, Gemini и других популярных моделей в одном месте для удобного переключения.

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

Способ 1: Использование Google Generative AI SDK (рекомендуется)

Установите SDK:

pip install google-generativeai

Минимальный пример вызова (Text-to-Image, всего 10 строк кода):

import google.generativeai as genai
import base64

genai.configure(
    api_key="YOUR_API_KEY",
    # Используем эндпоинт APIYI, цена всего $0.05 за запрос
    client_options={"api_endpoint": "vip.apiyi.com"}
)

model = genai.GenerativeModel("gemini-3-pro-image-preview")
response = model.generate_content(
    "Рыжий кот сидит в поле подсолнухов, яркий солнечный свет, реализм, 4K HD",
    generation_config=genai.GenerationConfig(
        response_modalities=["IMAGE"],
        resolution="4K",
        aspect_ratio="16:9"
    )
)

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

🚀 Быстрый старт: После регистрации на APIYI (apiyi.com) вы получите API-ключ и бесплатный тестовый баланс. Просто скопируйте код выше, замените YOUR_API_KEY, и запускайте — никаких дополнительных настроек не требуется.

import google.generativeai as genai
import base64
import os
from pathlib import Path
from typing import Optional, List


def setup_client(api_key: str):
    """Инициализация клиента Nano Banana Pro API"""
    genai.configure(
        api_key=api_key,
        # Вызов через APIYI, цена $0.05 за запрос, что на 79% дешевле официальной цены
        client_options={"api_endpoint": "vip.apiyi.com"}
    )
    return genai.GenerativeModel("gemini-3-pro-image-preview")


def text_to_image(
    model,
    prompt: str,
    resolution: str = "2K",       # 1K / 2K / 4K
    aspect_ratio: str = "1:1",    # 1:1 / 16:9 / 9:16 / 4:3 / 3:4
    output_path: str = "output.png"
) -> str:
    """
    Text-to-Image: генерация изображения по текстовому описанию

    Args:
        model: инициализированный экземпляр модели
        prompt: промпт (поддерживается русский и английский)
        resolution: разрешение 1K/2K/4K
        aspect_ratio: соотношение сторон
        output_path: путь для сохранения

    Returns:
        Путь к сохраненному файлу
    """
    response = model.generate_content(
        prompt,
        generation_config=genai.GenerationConfig(
            response_modalities=["IMAGE"],
            resolution=resolution,
            aspect_ratio=aspect_ratio
        )
    )

    for part in response.candidates[0].content.parts:
        if part.inline_data and part.inline_data.mime_type.startswith("image/"):
            with open(output_path, "wb") as f:
                f.write(base64.b64decode(part.inline_data.data))
            return output_path

    raise ValueError("API не вернул данные изображения, проверьте промпт на фильтрацию контента")


def image_to_image(
    model,
    prompt: str,
    reference_image_path: str,
    resolution: str = "2K",
    output_path: str = "edited_output.png"
) -> str:
    """
    Image-to-Image: редактирование или стилизация на основе референсного изображения

    Args:
        model: инициализированный экземпляр модели
        prompt: инструкции по редактированию (например, "измени фон на ночной")
        reference_image_path: путь к исходному изображению
        resolution: разрешение на выходе
        output_path: путь для сохранения

    Returns:
        Путь к сохраненному файлу
    """
    # Чтение референсного изображения
    with open(reference_image_path, "rb") as f:
        image_data = base64.b64encode(f.read()).decode()

    # Определение формата изображения
    ext = Path(reference_image_path).suffix.lower()
    mime_map = {".jpg": "image/jpeg", ".jpeg": "image/jpeg",
                ".png": "image/png", ".webp": "image/webp"}
    mime_type = mime_map.get(ext, "image/png")

    response = model.generate_content(
        [
            {"inline_data": {"mime_type": mime_type, "data": image_data}},
            prompt
        ],
        generation_config=genai.GenerationConfig(
            response_modalities=["IMAGE"],
            resolution=resolution
        )
    )

    for part in response.candidates[0].content.parts:
        if part.inline_data and part.inline_data.mime_type.startswith("image/"):
            with open(output_path, "wb") as f:
                f.write(base64.b64decode(part.inline_data.data))
            return output_path

    raise ValueError("Ошибка Image-to-Image, убедитесь, что формат исходного изображения корректен")


def batch_generate(
    model,
    prompts: List[str],
    resolution: str = "2K",
    output_dir: str = "batch_output"
) -> List[str]:
    """
    Пакетная генерация изображений

    Args:
        model: экземпляр модели
        prompts: список промптов
        resolution: разрешение
        output_dir: директория для вывода

    Returns:
        Список путей к сгенерированным файлам
    """
    os.makedirs(output_dir, exist_ok=True)
    results = []

    for i, prompt in enumerate(prompts):
        output_path = f"{output_dir}/image_{i+1:03d}.png"
        try:
            path = text_to_image(model, prompt, resolution, output_path=output_path)
            results.append(path)
            print(f"[{i+1}/{len(prompts)}] Успешно: {path}")
        except Exception as e:
            print(f"[{i+1}/{len(prompts)}] Ошибка: {e}")
            results.append(None)

    return results


# Пример использования
if __name__ == "__main__":
    # Инициализация клиента через APIYI (apiyi.com), $0.05 за запрос
    model = setup_client("YOUR_APIYI_API_KEY")

    # Пример Text-to-Image
    path = text_to_image(
        model,
        prompt="Современная минималистичная презентация продукта, белый фон, студийный свет, подходит для e-commerce",
        resolution="4K",
        aspect_ratio="1:1",
        output_path="product_4k.png"
    )
    print(f"Продукт в 4K сгенерирован: {path}")

    # Пример Image-to-Image (изменение существующего изображения)
    edited = image_to_image(
        model,
        prompt="Измени фон на природный пейзаж, сохранив основной объект без изменений",
        reference_image_path="product_4k.png",
        resolution="4K",
        output_path="product_outdoor.png"
    )
    print(f"Отредактированное изображение: {edited}")

Способ 2: Прямой HTTP-запрос (подходит для любого языка)

Если вы не хотите устанавливать SDK, можно отправлять обычные HTTP POST запросы:

import requests
import base64
import json

API_KEY = "YOUR_APIYI_API_KEY"
# Эндпоинт APIYI, совместимый с нативным форматом Google
BASE_URL = "https://vip.apiyi.com/v1beta/models/gemini-3-pro-image-preview:generateContent"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

payload = {
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Футуристичный дата-центр, синий неоновый свет, 4K Ultra HD, кинематографичное качество"
                }
            ]
        }
    ],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "resolution": "4K",
        "aspectRatio": "16:9"
    }
}

response = requests.post(BASE_URL, headers=headers, json=payload)
data = response.json()

# Извлечение и сохранение изображения
image_data = data["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("datacenter_4k.png", "wb") as f:
    f.write(base64.b64decode(image_data))
print("Генерация изображения завершена!")

Примечание: Код выше использует совместимый эндпоинт APIYI (apiyi.com), который полностью повторяет формат Google Gemini API. Никакой конвертации не нужно, цена — $0.05 за запрос.

Подробный разбор ключевых параметров Nano Banana Pro

Таблица характеристик: разрешение и соотношение сторон

Поддерживаемые соотношения сторон (параметр aspectRatio):

Горизонтальные: "16:9"  "4:3"  "3:2"  "21:9"
Квадратные: "1:1"
Вертикальные: "9:16"  "3:4"  "2:3"  "9:21"
Кастомные: "4:5" (рекомендовано для Instagram)

Как выжать максимум из промптов

Nano Banana Pro очень чувствительна к качеству промпта. Вот проверенная формула успеха:

Структура идеального промпта: Описание объекта + Стиль + Освещение/Текстура + Разрешение/Качество

✅ Рекомендуемый вариант:
"Молодая женщина в традиционном ханьфу стоит в классическом китайском саду, 
 стиль гунби, мягкий естественный свет, высокая детализация, 4K ультра-четкость, 
 фотореализм"

❌ Чего стоит избегать:
"Нарисуй девушку" (слишком размыто)

Промпты для рендеринга текста (главная фишка Nano Banana Pro):

"Рекламный постер мероприятия, заголовок '2026 AI Summit', 
 на двух языках (китайский и английский), современный дизайн, темно-синий фон, 
 белый шрифт заголовка, текст четкий и читаемый"

Реальные сценарии использования Nano Banana Pro API

Сценарий 1: Массовая генерация изображений для e-commerce

# Массовая генерация демонстрационных изображений товаров
product_prompts = [
    "Беспроводные наушники, чисто белый фон, профессиональное фото товара, вид спереди, 4K",
    "Беспроводные наушники, темно-серый фон, вид под углом 45 градусов, детализация корпуса, 4K",
    "Беспроводные наушники, лайфстайл-фото, человек в наушниках на улице в солнечный день, 4K"
]

results = batch_generate(
    model,
    product_prompts,
    resolution="4K",
    output_dir="product_images"
)
# 3 изображения, общая стоимость на APIYI: $0.15 (на KIE.ai вышло бы $0.36)

Сценарий 2: Дизайн маркетинговых постеров с текстом

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

poster_prompt = """
Дизайн рекламного постера для распродажи 11.11:
- Заголовок: ГРАНДИОЗНАЯ РАСПРОДАЖА
- Подзаголовок: Скидки до 50%
- Фон: Красный градиент, праздничный стиль
- Цвет текста: Золотистый, крупный заметный шрифт
- Внизу: Сроки акции 11.11.2026 - 13.11.2026
Требование: Текст должен быть четким и читаемым, профессиональная верстка
"""

path = text_to_image(model, poster_prompt, resolution="4K", aspect_ratio="9:16")
# Вертикальный постер для сторис, $0.05 за штуку

💡 Совет: Если вам нужно генерировать изображения в промышленных масштабах (например, карточки товаров или рекламные креативы), лучше делать это через платформу APIYI (apiyi.com). Там не только самые низкие цены, но и удобные логи вызовов со статистикой расходов.

Сценарий 3: Интеграция в проекты на Node.js / TypeScript

Если ваш проект написан на JavaScript/TypeScript, интеграция через HTTP-запросы займет пару минут:

import axios from "axios";
import * as fs from "fs";

const API_KEY = "YOUR_APIYI_API_KEY";
// APIYI полностью совместим с форматом Google, цена $0.05 за запрос
const BASE_URL = "https://vip.apiyi.com/v1beta/models/gemini-3-pro-image-preview:generateContent";

interface GenerateImageOptions {
  prompt: string;
  resolution?: "1K" | "2K" | "4K";
  aspectRatio?: string;
  outputPath?: string;
}

async function generateImage({
  prompt,
  resolution = "2K",
  aspectRatio = "1:1",
  outputPath = "output.png",
}: GenerateImageOptions): Promise<string> {
  const response = await axios.post(
    BASE_URL,
    {
      contents: [{ role: "user", parts: [{ text: prompt }] }],
      generationConfig: {
        responseModalities: ["IMAGE"],
        resolution,
        aspectRatio,
      },
    },
    {
      headers: {
        "Content-Type": "application/json",
        Authorization: `Bearer ${API_KEY}`,
      },
    }
  );

  const imageData =
    response.data.candidates[0].content.parts[0].inlineData.data;
  fs.writeFileSync(outputPath, Buffer.from(imageData, "base64"));
  return outputPath;
}

// Пример использования
generateImage({
  prompt: "Стартовый экран приложения в стиле минимализм, темная тема, технологично, 4K",
  resolution: "4K",
  aspectRatio: "9:16",
  outputPath: "app_splash.png",
}).then((path) => console.log(`Готово: ${path}`));

Стратегии оптимизации затрат

В реальных проектах важно грамотно контролировать бюджет на API:

🎯 Рекомендация: Стартапам и индивидуальным разработчикам советую сначала потестить модель на бесплатном лимите APIYI (apiyi.com). Когда убедитесь, что качество картинок вас устраивает, можно переходить на платную основу — там оплата по факту, без минимальных чеков.

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

Итоги

Главное о вызове Nano Banana Pro API:

1. Используйте нативный формат Gemini: Обязательно используйте SDK google-generativeai или прямые HTTP-запросы. Формат OpenAI SDK не поддерживается.
2. Выгодная цена на APIYI: $0.05 за запрос — это на 44% дешевле, чем на KIE.ai ($0.09), и на 79% дешевле официальных цен Google ($0.24).
3. 3 ключевых параметра: responseModalities: ["IMAGE"], resolution (1K/2K/4K) и aspectRatio.
4. Рендеринг текста — главное преимущество: Для маркетинговых постеров, инфографики и двуязычного контента Nano Banana Pro сейчас является лучшим выбором.

Для команд, которым нужны массовые вызовы или развертывание в продакшн-среде, рекомендуем подключаться через APIYI apiyi.com. Платформа работает стабильно, предоставляет подробные логи API и мониторинг использования, что помогает точно контролировать расходы на генерацию изображений.

Полезные ссылки

1. Документация Google Gemini API по генерации изображений

   • Ссылка: ai.google.dev/gemini-api/docs/image-generation
   • Описание: Официальная спецификация параметров API и ограничения на использование Nano Banana Pro.

2. Google Generative AI Python SDK

   • Ссылка: github.com/google-gemini/generative-ai-python
   • Описание: Установка SDK и полный справочник по API. Код в этой статье написан с использованием этого SDK.

3. Документация по подключению Nano Banana Pro на платформе APIYI

   • Ссылка: docs.apiyi.com
   • Описание: Сведения о совместимости APIYI с нативными форматами Google и детали тарификации.

Автор: Техническая команда
Обмен опытом: Делитесь в комментариях своими работами, созданными с помощью Nano Banana Pro! Еще больше лайфхаков по генерации изображений с помощью ИИ можно найти в техническом сообществе APIYI на apiyi.com.