Skip to main content
POST
Text-to-image: generate an image from a text description
Интерактивный Playground справа поддерживает выбор параметров в выпадающих списках (соотношение сторон, тип ответа и т. д.). Введите свой API Key в поле Authorization (формат: Bearer sk-xxx), чтобы отправлять тестовые запросы в один клик.
Область применения: Эта страница предназначена для генерации изображений по тексту. Просто введите prompt — загрузка изображения не требуется. Для редактирования существующего изображения используйте эндпоинт редактирования изображений.
🖥️ Ограничение Browser Playground (важно)Этот эндпоинт возвращает base64-кодированное изображение (inlineData.data, обычно несколько MB) в ответе. Из-за ограничений браузерного рендеринга Playground справа после получения ответа может показать 请求时发生错误: unable to complete requestзапрос на самом деле выполнен успешно; браузер просто не может отрисовать такую длинную base64-строку.Рекомендуемый рабочий процесс (подходит для начинающих):
  • Скопируйте пример Python / Node.js / cURL ниже и запустите его локально. Код автоматически base64.b64decodes ответ и сохраняет изображение в файл.
  • Nano Banana 2 Lite ориентирован на холст 1K, поэтому ответ имеет умеренный размер, но запуск локально по-прежнему остается самым безопасным способом сохранить изображение.
Все image API являются синхронными — здесь нет task ID для опроса, и если ваш client отключится, результат будет потерян, хотя запрос все равно тарифицируется. Для этой модели задайте большой timeout; см. Основы Image API и лучшие практики.

Примеры кода

Python

cURL

Node.js

Режим, совместимый с OpenAI

Краткая справка по параметрам

См. описания полей в Playground справа для получения подробной документации по параметрам, допустимым значениям и значениям по умолчанию. Все поля типа enum (например, aspectRatio) поддерживают выбор из выпадающего списка — ручной ввод не требуется.
Переход с Nano Banana 2: просто измените название модели с gemini-3.1-flash-image на gemini-3.1-flash-lite-image; остальные параметры оставьте без изменений. Учтите, что Lite поддерживает только 1K — если вы передаете 2K/4K, вернитесь к 1K.

Авторизации

Authorization
string
header
обязательно

API Key obtained from the APIYI console

Тело

application/json
contents
object[]
обязательно

Content array containing the text prompt

generationConfig
object
обязательно

Ответ

Image generated successfully

candidates
object[]

Array of generation results

usageMetadata
object