Логотип LlamaGen

Рабочие процессы Nano Banana 2.1

Запустите Nano Banana 2.1 через API изображений Google Cloud

Локальный скрипт может отправлять прямой запрос в Google Cloud. Явно задавайте аутентификацию, выбор модели, настройки изображения и обработку результата, чтобы неудачный ответ без изображения не превратился незаметно в успешный экспорт.

Что вы создадите

Прямой SDK-запрос и чек-лист проверки для управляемого вами проекта Google Cloud. Это не доступ к публичному LlamaGen API.

Создать с Nano Banana 2.1

Для Nano Banana 2.1 нужен платный тариф LlamaGen. Перед генерацией проверьте текущую стоимость в кредитах и доступные варианты экспорта. Оплата через прямой Google Cloud API производится отдельно. Тарифы и кредиты

Готовый визуал, сгенерированный ИИ, показан в обычной творческой среде.
Концепт презентации ИИ: готовый визуал в использовании. Эта сцена отделена от прямого результата модели ниже.

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

Редакционные материалы LlamaGen

Материал проверен:

Посмотреть пример генерации

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

Референсные изображения, использованные в workflow генерации

Это собственные вымышленные референсные материалы. Их наличие не гарантирует точное совпадение личности или деталей продукта в результате.

Прямой результат генерации изображения Nano Banana 2.1 для workflow, описанного на этой странице.
Прямой результат Nano Banana 2.1 из документированного 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

  1. Подготовьте учётные данные и проект вне исходного файла.
  2. Выполните небольшой запрос с поддерживаемыми настройками изображения.
  3. Проверьте возвращённые части изображения, сохраните с правильным 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.

Если ответ без изображения, нужно сразу повторить запрос?

Сначала проверьте ответ и актуальные рекомендации провайдера. Фильтры, лимиты и временные сбои могут приводить к разным результатам. Это руководство не обещает, что повторная попытка будет успешной или бесплатной.