HiAPI
Блог

Руководство по использованию

Руководство по генерации изображений из текста в базовой версии Nano Banana: формат кадра, свободное пространство и использование промптов

Используйте поля aspect_ratio и prompt интерфейса задач для генерации изображений с чёткой композицией для баннеров и социальных карточек

Nov 18, 2026
Плоская геометрическая обложка на фоне тёплого песочного цвета с горизонтальными ступенчатыми полосами терракотового и охристого оттенков, убывающими слева направо, с достаточными полями по краям.
На этой странице

Позиционирование и границы этой линии

nano-banana в HiAPI — это линия генерации изображений из текста (text-to-image), задания в которой отправляются асинхронно: входные поля в теле запроса единообразно помещаются в объект input, а после отправки результат получается в режиме задачи. Она подходит для сценариев с массовой генерацией иллюстраций, например операционных баннеров, социальных карточек, черновиков иллюстраций к статьям. В этой статье рассматривается только базовая версия, другие модели той же серии не затрагиваются.

Доступных полей немного, поэтому сначала чётко опишем контракт: prompt — обязательная строка длиной 1–5000 символов; aspect_ratio — необязательное, по умолчанию auto, перечисление: auto, 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9; output_format — необязательное, png или jpeg, по умолчанию png. Устаревшее поле image_size выведено из использования; для указания целевого формата кадра используйте aspect_ratio.

Следует подчеркнуть, что данная линия не предоставляет поля resolution, quality, width, height, seed, а также загрузку референсных изображений. Не добавляйте эти ключи в input по привычке от других моделей изображений и не предполагайте, что они будут молча проигнорированы. Аналогично, aspect_ratio задаёт целевое соотношение сторон кадра и не гарантирует фиксированный размер в пикселях; фактический формат и пиксели определяйте по возвращённому изображению, проверяйте перед сдачей.

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

Контракт полей и минимальный фрагмент input

Ниже приведён фрагмент input, содержащий только вышеуказанные поля, для пояснения иерархии полей. Это не полный HTTP-запрос: не указаны endpoint, заголовки аутентификации и способ опроса задачи — за ними обращайтесь к документации API HiAPI.

{
  "input": {
    "prompt": "Плоская геометрическая иллюстрация в горизонтальной композиции, тёплый песочный фон, справа треть кадра занимает ступенчатая структура из цветовых блоков, слева свободное пространство, без текста на изображении.",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }
}

Способ написания prompt влияет на управляемость изображения. Практичный порядок: сначала описать субъект и сцену, затем композицию и положение субъекта, затем область свободного пространства, и наконец цвет, свет и стиль. Если на изображении не нужен текст, явно напишите «на изображении не должно быть никакого текста, букв и цифр» — это проще, чем исправлять изображение потом. Необязательно заполнять все 5000 символов; достаточно чётко изложить ключевые ограничения; слишком длинные нагромождения, наоборот, размывают акценты.

Выбор output_format определяется цепочкой поставки: png подходит для сохранения без потерь и последующего редактирования, jpeg — для поставки со сжатием с потерями. По умолчанию png; если для нижестоящих систем важен объём, не забудьте явно указать jpeg. Следует пояснить: возможность выбрать png не означает, что модель создаёт альфа-канал прозрачности; данная линия не имеет заявлений или полей о способности к прозрачному фону и не гарантирует удаление фона или прозрачный вывод.

Формат кадра и свободное пространство: сначала задайте макет, затем пишите промпт

Свободное пространство — это не «пустота», а место, зарезервированное для заголовка, кнопок, угловых меток. Для разных форматов кадра стратегии свободного пространства различаются; при написании промпта следует описывать свободное пространство как часть композиции.

  • Баннер 16:9: часто используется для шапки сайта и обложки статьи. Рекомендуется сместить субъект в правую или левую треть, а на другой стороне оставить непрерывную область с низкой информативностью, чтобы субъект не перекрывал заголовок. В промпте можно написать «слева сохранить область свободного пространства с низким контрастом шириной около трети кадра».
  • Социальная карточка 1:1: субъект по центру, сверху и снизу по кругу «воздуха»; элементы по краям не должны прилегать к границе, чтобы их не обрезало при кадрировании в ленте.
  • Вертикальный 9:16: сверху и снизу оставить по полосе для заголовка и подписи; субъект разместить в средней части, чтобы он не пересекался с текстовыми зонами по краям.
  • 4:5 и 3:4: распространённые пропорции, близкие к печати и лентам; свободного пространства можно меньше, но безопасные поля по краям всё же рекомендуется сохранять.
  • Сверхширокий 21:9: горизонтального пространства достаточно, удобно выстраивать несколько элементов в ритм, но края легко обрезаются — важный субъект не должен прилегать к границе.
  • auto: пропорции определяет сервер, подходит для раннего исследования; как только начинается массовое производство, рекомендуется явно указывать пропорции, чтобы уменьшить переделки макета.

Снова подчеркнём: пропорции не равны пикселям. aspect_ratio задаёт целевое соотношение сторон кадра; 16:9 не означает фиксированный размер в пикселях (например, 1920×1080). После получения изображения следует проверить, соответствует ли фактический формат ожидаемому; если нижестоящие системы имеют жёсткие требования по размеру, масштабируйте или обрезайте самостоятельно, а безопасные поля закладывайте уже на этапе промпта.

Два примера промптов, которые можно сразу переписать под себя

Следующие два варианта — это формулировки, требующие проверки, а не подтверждённые результаты. Рекомендуется сначала вызвать каждый по одному разу, посмотреть, соответствуют ли положение субъекта и свободное пространство ожиданиям, а затем адаптировать под проект.

Баннер со свободным пространством (16:9):

«Плоская геометрическая иллюстрация в горизонтальной композиции, тёплый песочный фон. В правой трети кадра разместить ступенчатую структуру из блоков терракотового, охристого и тёмно-коричневого цветов, ступенчато спускающуюся слева направо, с чистыми краями; левые две трети кадра оставить областью свободного пространства с низким контрастом и без деталей, сохранив лишь очень бледную горизонтальную цветовую полосу как переход. Общая тональность сдержанная, без градиентного шума, без текста, букв, цифр и логотипов, композиция уравновешенная, подходит как шапка статьи.»

Социальная карточка (1:1):

«Минималистичная иллюстрация в квадратной композиции, светло-бежевый фон. В центре кадра разместить абстрактный знак из трёх пересекающихся дуг, цвет — тёмно-зелёный и охра, линии равномерной толщины; вокруг знака сохранить равномерное свободное пространство, сверху и снизу чуть больше, чем слева и справа, чтобы удобно было наложить заголовок. Фон чистый, без текстуры, без теней, без текста, букв, цифр и логотипов, общее впечатление спокойное, сдержанное.»

В обоих промптах «свободное пространство» описано как исполняемое пространственное описание, а не фразой «побольше свободного места». Если сгенерированный субъект всё ещё прилегает к краю, в первую очередь корректируйте пространственные слова и доли в описании, а не бесконечно добавляйте прилагательные.

Пошаговая итерация: меняйте только одну переменную за раз

Самая частая ошибка при массовой генерации — менять сразу prompt, пропорции и формат, а потом не понимать, что именно вызвало изменение. Более надёжный подход — сходиться по шагам.

  • Шаг первый: зафиксировать aspect_ratio и output_format, коротким промптом проверить, правильно ли понимается субъект.
  • Шаг второй: добавить описание композиции: положение субъекта, доля кадра, область свободного пространства.
  • Шаг третий: добавить цвет, свет и стиль, посмотреть, не сжимается ли свободное пространство.
  • Шаг четвёртый: оформить стабилизированное описание в шаблон; при массовой генерации заменять только субъект и цветовую гамму, не меняя структурные предложения.

После каждого вызова фиксируйте prompt, aspect_ratio, output_format и различия в результатах. Записи сами по себе — актив: когда в одной партии задач появляется систематическое смещение, по записям можно быстро определить, выбрана ли неверная пропорция, изменена ли структура промпта или есть проблема с написанием полей.

Самопроверка перед сдачей и обработка ошибок

После получения изображения проверьте следующее: соответствует ли формат кадра целевому соотношению aspect_ratio; целостен ли субъект, не обрезан ли; достаточно ли чиста зарезервированная текстовая зона; не появились ли на изображении нежелательный текст или элементы, похожие на водяные знаки; соответствует ли выходной формат требованиям нижестоящих систем. Если изображение用于 баннер, additionally просмотрите его в фактическом размере страницы и убедитесь, что после наложения заголовка субъект не перекрывается.

При сбое задачи или отклонении результата проверяйте по порядку: не пуст ли prompt и не выходит ли за 1–5000 символов; входит ли aspect_ratio в перечисление; используется ли в output_format только png или jpeg; не использовано ли по ошибке устаревшее image_size; не переданы ли поля, не предоставляемые данной линией. Убедившись в корректности параметров, упростите промпт и повторите попытку, а не отправляйте снова тот же ввод. Если отклонения повторяются несколько раз, сначала сведите элементы изображения к минимуму, затем добавляйте по одному.

Последнее напоминание: иллюстрации в статье являются лишь концептуальными схемами, поясняющими процесс «ввод через канал задачи преобразуется в изображение», и не являются реальным выводом nano-banana. Все комбинации промптов и полей рекомендуется сначала проверить самостоятельным вызовом, а затем запускать в производственный процесс. Подробности о модели см. в /models/nano-banana.

Похожие статьи

Все статьи →

Начните работать с постоянными артефактами ИИ

Получите API-ключ и вызывайте модели изображений, видео и аудио через один API на основе tasks.

Читать документацию API