Nano Banana Pro Text to Image Ultra

Обзор

Nano Banana Pro Text to Image Ultra — эндпоинт Text-to-Image семейства Nano Banana Pro от Google, представленного в ноябре 2025 года как Gemini 3 Pro Image. Эта разновидность предназначена для генерации изображения с нуля по текстовому описанию, без входных референсов: промпт задаёт сцену, композицию, стиль, соотношение сторон, формат и целевое разрешение 4K или 8K. На фоне родственных моделей линейки Ultra-версия выделяется фокусом на финальном качестве и высоком разрешении: в отличие от edit-вариантов она не правит существующие изображения, а создаёт новый кадр по описанию; в отличие от обычного эндпоинта Text-to-Image лучше подходит для готовых постеров, концепт-артов, продуктовых визуалов, инфографики и сцен, где важны детализация и читаемый текст. Главное помнить: Nano Banana Pro сильнее всего раскрывается в конкретных промптах с явным описанием композиции, света, камеры и текста, но фактические данные в диаграммах, мелкие надписи и сложную типографику всё равно стоит проверять вручную.

Сильные стороны

Сценари использования (use cases)

Ограничения и недостатки

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

Советы

• Стройте промпт по схеме: субъект → композиция → действие → локация → стиль. Официальный каркас Google для Nano Banana Pro даёт модели чёткие опорные точки и заметно стабильнее удерживает сцену, чем разрозненный список слов.
• Задайте соотношение сторон и в параметре, и в тексте промпта. Фразы вроде «вертикальный постер 9:16» или «кинематографичный кадр 21:9» помогают удержать композицию внутри выбранного формата, а не только размер холста.
• Для текста в кадре заключайте точную фразу в кавычки и опишите шрифт. Модель лучше отрисовывает буквы, когда строка задана буквально, а не общими словами «добавь надпись». Для макетов с типографикой безопаснее начинать с PNG.
• Не перечисляйте, чего не должно быть в кадре — описывайте желаемый результат. Модель сильнее реагирует на позитивные формулировки: «пустая улица» работает лучше, чем «без машин». Списки исключений из классических диффузионных моделей здесь обычно не помогают.
• Не принимайте надписи, факты и мелкие детали без ручной проверки. Даже в версии Ultra модель может ошибиться в орфографии, данных на инфографике и мелком тексте — Google прямо указывает это как текущее ограничение.

FAQ

Цены

Параметры

Поля тела JSON-запроса, которые используются в Playground и доступны для настройки через API. Порядок совпадает с формой на странице.

Запрос

Асинхронный запуск: POST https://api.flixa.io/v1/image/nano-banana-pro/ultra-text-to-image с заголовком Authorization: Bearer $FLIXA_API_KEY и телом JSON. Ниже — пример с полями из Playground.

curl -X POST "https://api.flixa.io/v1/image/nano-banana-pro/ultra-text-to-image" \
  -H "Authorization: Bearer $FLIXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Превратите это фото товара в премиальную студийную рекламу: мягкий кинематографический свет, чистый бежевый фон, лёгкие тени, реалистичные отражения и эстетика люксового бренда.",
  "resolution": "4k",
  "aspect_ratio": "21:9",
  "output_format": "jpeg"
}'

import json
import os
import requests

url = "https://api.flixa.io/v1/image/nano-banana-pro/ultra-text-to-image"
payload = json.loads({"aspect_ratio": "21:9", "output_format": "jpeg", "prompt": "\u041f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u0435 \u044d\u0442\u043e \u0444\u043e\u0442\u043e \u0442\u043e\u0432\u0430\u0440\u0430 \u0432 \u043f\u0440\u0435\u043c\u0438\u0430\u043b\u044c\u043d\u0443\u044e \u0441\u0442\u0443\u0434\u0438\u0439\u043d\u0443\u044e \u0440\u0435\u043a\u043b\u0430\u043c\u0443: \u043c\u044f\u0433\u043a\u0438\u0439 \u043a\u0438\u043d\u0435\u043c\u0430\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0441\u0432\u0435\u0442, \u0447\u0438\u0441\u0442\u044b\u0439 \u0431\u0435\u0436\u0435\u0432\u044b\u0439 \u0444\u043e\u043d, \u043b\u0451\u0433\u043a\u0438\u0435 \u0442\u0435\u043d\u0438, \u0440\u0435\u0430\u043b\u0438\u0441\u0442\u0438\u0447\u043d\u044b\u0435 \u043e\u0442\u0440\u0430\u0436\u0435\u043d\u0438\u044f \u0438 \u044d\u0441\u0442\u0435\u0442\u0438\u043a\u0430 \u043b\u044e\u043a\u0441\u043e\u0432\u043e\u0433\u043e \u0431\u0440\u0435\u043d\u0434\u0430.", "resolution": "4k"})

response = requests.post(
    url,
    headers={"Authorization": f"Bearer {os.environ['FLIXA_API_KEY']}"},
    json=payload,
    timeout=120,
)
print(response.json())

const response = await fetch(
  "https://api.flixa.io/v1/image/nano-banana-pro/ultra-text-to-image",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FLIXA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"aspect_ratio": "21:9", "output_format": "jpeg", "prompt": "\u041f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u0435 \u044d\u0442\u043e \u0444\u043e\u0442\u043e \u0442\u043e\u0432\u0430\u0440\u0430 \u0432 \u043f\u0440\u0435\u043c\u0438\u0430\u043b\u044c\u043d\u0443\u044e \u0441\u0442\u0443\u0434\u0438\u0439\u043d\u0443\u044e \u0440\u0435\u043a\u043b\u0430\u043c\u0443: \u043c\u044f\u0433\u043a\u0438\u0439 \u043a\u0438\u043d\u0435\u043c\u0430\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0441\u0432\u0435\u0442, \u0447\u0438\u0441\u0442\u044b\u0439 \u0431\u0435\u0436\u0435\u0432\u044b\u0439 \u0444\u043e\u043d, \u043b\u0451\u0433\u043a\u0438\u0435 \u0442\u0435\u043d\u0438, \u0440\u0435\u0430\u043b\u0438\u0441\u0442\u0438\u0447\u043d\u044b\u0435 \u043e\u0442\u0440\u0430\u0436\u0435\u043d\u0438\u044f \u0438 \u044d\u0441\u0442\u0435\u0442\u0438\u043a\u0430 \u043b\u044e\u043a\u0441\u043e\u0432\u043e\u0433\u043e \u0431\u0440\u0435\u043d\u0434\u0430.", "resolution": "4k"}),
  }
);

console.log(await response.json());

Пример ответа

Сразу после POST приходит объект с идентификатором задачи и статусом (queued или processing). Готовый результат — в поле outputs после завершения.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2026-05-22T12:00:00Z"
}

После успешного завершения:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "outputs": [
    { "url": "https://storage.example/result.png", "type": "image" }
  ]
}

Поллинг

Пока задача в работе, опрашивайте GET https://api.flixa.io/v1/predictions/{id}/result с тем же API-ключом. Рекомендуемый интервал — 1–2 секунды; остановитесь при completed, failed или cancelled.

• queued / processing — продолжайте опрос.
• completed — заберите URL из outputs.
• failed — смотрите error в теле ответа.

curl "https://api.flixa.io/v1/predictions/{id}/result" \
  -H "Authorization: Bearer $FLIXA_API_KEY"