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

Примеры кода

Python

cURL

Node.js

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

Подробные описания параметров, допустимые значения и значения по умолчанию см. в описаниях полей в Playground справа. Все поля типа enum (например, aspectRatio, imageSize) поддерживают выбор из выпадающего списка — ручной ввод не требуется.
Неподдерживаемые функцииСледующие официальные функции Google не поддерживаются через APIYI и требуют отдельной тарификации:
  • Grounding с Google Search: Информация поиска в реальном времени через tools: [{"google_search": {}}]
  • thinkingConfig (режим Thinking): Поддерживается только в Nano Banana 2, но не в Nano Banana Pro
По вопросам функций search grounding свяжитесь со службой поддержки, чтобы узнать о вариантах отдельной тарификации.

Авторизации

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

API Key from APIYI Console

Тело

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

Content array containing the text prompt

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

Ответ

Image generated successfully

candidates
object[]

Generated results array

usageMetadata
object