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

Примеры кода

Python

cURL

Node.js

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

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

Авторизации

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