Рабочие процессы Nano Banana 2.1
Запустите Nano Banana 2.1 через API изображений Google Cloud
Локальный скрипт может отправлять прямой запрос в Google Cloud. Явно задавайте аутентификацию, выбор модели, настройки изображения и обработку результата, чтобы неудачный ответ без изображения не превратился незаметно в успешный экспорт.
Что вы создадите
Прямой SDK-запрос и чек-лист проверки для управляемого вами проекта Google Cloud. Это не доступ к публичному LlamaGen API.
Для Nano Banana 2.1 нужен платный тариф LlamaGen. Перед генерацией проверьте текущую стоимость в кредитах и доступные варианты экспорта. Оплата через прямой Google Cloud API производится отдельно. Тарифы и кредиты

Hero-изображение — это концепт презентации, сгенерированный ИИ и показывающий готовый результат в контексте. Это не фотография клиента, не скриншот приложения и не отдельный тест производительности модели.
Материал проверен:
Посмотреть пример генерации
Ниже показан прямой результат модели из нашего документированного процесса генерации. Проверяйте само изображение, не предполагая, что модель выполнила все инструкции.
Референсные изображения, использованные в workflow генерации
Это собственные вымышленные референсные материалы. Их наличие не гарантирует точное совпадение личности или деталей продукта в результате.

Подготовьте свой доступ к Google Cloud
В актуальной документации Google платформа называется Gemini Enterprise Agent Platform; многие разработчики по-прежнему ищут её под прежним названием Vertex AI. Пример здесь следует версии @google/genai 1.45.0, установленной в нашем локальном workflow генерации, с использованием vertexai: true. В более новых версиях SDK названия опций могут измениться; ориентируйтесь на документацию к установленной версии.
Используйте проект с подключённым биллингом, включённой нужной службой и учётными данными, авторизованными для запроса. Храните файлы service account и токены доступа вне исходного кода, содержимого страницы и промптов изображений. Стоимость Cloud API оплачивается отдельно от любого тарифа LlamaGen.
- Используйте точный model ID gemini-nano-banana-2.1.
- Используйте расположение global, указанное в документации для этой модели.
- Следуйте инструкциям Google по аутентификации и настройке проекта для вашей среды.
Передавайте только настройки, поддерживаемые этим endpoint
Для этой Cloud-модели в документации указаны размеры вывода 1K, 2K и 4K. На текущей странице модели Cloud указано максимум 14 входных изображений на промпт и лимит 7 МБ на файл для встроенных данных изображений; для входных данных из Cloud Storage действует другой лимит. Это ограничения конкретного endpoint, а не обещание, что любая комбинация подойдёт как хороший творческий бриф.
В документации Cloud прямо сказано, что seed, temperature, topP, topK и logprobs не поддерживаются в Nano Banana 2.1. Не копируйте эти настройки из примера для текстовой генерации и не описывайте seed как инструмент воспроизводимости для этой модели.
- Сделайте промпт и небольшой релевантный набор референсов легко проверяемыми.
- Используйте MIME type, соответствующий фактическим входным байтам.
- Зафиксируйте модель, настройки вывода и хэши референсов вместе с собственным результатом.
Проверьте, действительно ли вернулось изображение
Проверьте части ответа на наличие встроенных данных изображения, прежде чем сохранять файл вывода. Текстовый ответ, отфильтрованный результат или ответ без изображения следует рассматривать как результат для проверки, а не как завершённую генерацию.
Не повторяйте запросы вслепую. Сохраните неконфиденциальные метаданные запроса и статус ответа, проверьте ограничения в документации и изучите указанную причину. Прежде чем повторять запрос после ошибки с неясной причиной, разберитесь в текущих правилах оплаты вашего поставщика.
- Не логируйте учётные данные или полные приватные входные изображения.
- Сохраняйте MIME type возвращённого изображения при выборе расширения файла.
- Считайте возвращённое изображение кандидатом, который всё ещё нужно визуально проверить.
Разделите ключевые элементы
Эти проверки описывают прямой путь через Google Cloud. Они не предоставляют доступ к API и не заменяют актуальную документацию Google по настройке.
| Часть запроса | Используйте или проверьте | Не предполагайте |
|---|---|---|
| Аутентификация | Собственный проект Google Cloud с необходимыми разрешениями и учетные данные | Что подписка LlamaGen автоматически аутентифицирует запрос к Cloud API |
| Модель и локация | gemini-nano-banana-2.1 в global | Что похожий alias модели выбирает ту же модель |
| Настройки изображения | Поддерживаемые соотношение сторон, размер вывода и формат референса | Что seed или параметры сэмплирования текстовой модели поддерживаются |
| Ответ | Фактические байты изображения, MIME type и результат, который можно проверить | Что каждый успешный HTTP-ответ содержит изображение, готовое к публикации |
Практический workflow
От небольшого запроса к файлу, который можно проверить
Начните с одного простого запроса на оригинальное изображение. Пример ниже использует форму прямого SDK-запроса, применяемую в нашем локальном workflow генерации; замените окружение проекта и выполните аутентификацию через собственную одобренную настройку.
Стартовый промпт для адаптации
Создайте оригинального иллюстрированного курьера с фонарём на дождливой улице. Используйте чёткий силуэт и легко читаемую сцену. Не добавляйте текст или логотипы.
Этот бриф — гибкий шаблон, а не точный журнал запроса для показанного результата. Он не обещает идентичный результат или успешную генерацию с первого раза. В записи генерации сохраняется исходный запрос.
Попробовать workflow
- Подготовьте учётные данные и проект вне исходного файла.
- Выполните небольшой запрос с поддерживаемыми настройками изображения.
- Проверьте возвращённые части изображения, сохраните с правильным MIME type и оцените сам файл.
На что обратить внимание
- Действительно ли вернулась часть изображения?
- Открывается ли сохранённый файл корректно?
- Соответствует ли визуал брифу настолько, чтобы его оставить?
Пример прямого запроса через Google Cloud SDK
Это прямой запрос к Google Cloud с использованием вашего проекта и учётных данных. Это не публичный endpoint LlamaGen API. Не вставляйте приватные ключи в промпт или на публичную страницу.
import { GoogleGenAI } from "@google/genai";
import { writeFile } from "node:fs/promises";
// @google/genai 1.45.0, matching the documented local workflow.
// Authenticate outside this file using Google Cloud credentials.
const ai = new GoogleGenAI({
vertexai: true,
project: process.env.GOOGLE_CLOUD_PROJECT,
location: "global",
httpOptions: { apiVersion: "v1" },
});
const response = await ai.models.generateContent({
model: "gemini-nano-banana-2.1",
contents: [{ role: "user", parts: [{
text: "Create an original illustrated courier carrying a lantern in a rainy street. No text or logos.",
}] }],
config: {
responseModalities: ["IMAGE"],
candidateCount: 1,
imageConfig: { aspectRatio: "3:2", imageSize: "2K" },
thinkingConfig: { thinkingLevel: "HIGH" },
},
});
const image = response.candidates?.[0]?.content?.parts?.find(
(part) => part.inlineData?.data,
)?.inlineData;
if (!image?.data) throw new Error("No image returned; inspect the response before retrying.");
const extensions = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" };
const extension = extensions[image.mimeType];
if (!extension) throw new Error("Inspect the returned MIME type before saving.");
await writeFile(`nano-banana-2-1.${extension}`, Buffer.from(image.data, "base64"));Вопросы перед началом
Это публичный LlamaGen API?
Нет. В коде используется SDK Google для прямого обращения к Google Cloud с вашим собственным проектом и учетными данными. Страница модели LlamaGen — это отдельная карточка продукта.
Можно ли задать seed или temperature?
В текущей документации Cloud model указано, что seed, temperature, topP, topK и logprobs не поддерживаются для Nano Banana 2.1. Перед добавлением параметров запроса проверьте документацию конкретного endpoint.
Если ответ без изображения, нужно сразу повторить запрос?
Сначала проверьте ответ и актуальные рекомендации провайдера. Фильтры, лимиты и временные сбои могут приводить к разным результатам. Это руководство не обещает, что повторная попытка будет успешной или бесплатной.
Продолжить workflow
- Nano Banana 2.1 vs Pro: выбирайте под конкретную задачу
- Редактируйте изображение в Nano Banana 2.1, не теряя исходную задачу
- Создайте референс-лист персонажа, который действительно можно проверить
- Превратите короткую сцену в читаемый сториборд Nano Banana 2.1
- Разместите товар в lifestyle-сцене, не потеряв детали
