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

Примеры кода

Python

cURL

Node.js

Краткий справочник по параметрам

Подробную документацию по параметрам, допустимые значения и значения по умолчанию см. в описании полей в Playground справа. Все поля типа enum (например, aspectRatio, imageSize, thinkingLevel) поддерживают выбор из выпадающего списка — вводить вручную не требуется.
Привязка к Google Search (grounding): добавьте "tools": [{"googleSearch": {}}] на верхнем уровне запроса. Каждый поисковый запрос тарифицируется дополнительно в размере $0.014, а модель сама определяет, сколько запросов выполнить. См. обзор Nano Banana 2.1.

Авторизации

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

API Key obtained from APIYI Console

Тело

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

Content array containing text prompts

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

Ответ

Successfully generated image

candidates
object[]

Generation results array

usageMetadata
object