Skip to main content
POST
Image editing: edit an existing image per instructions
Интерактивная песочница справа поддерживает выбор параметров из выпадающего списка. Введите свой API Key в поле Authorization (формат: Bearer sk-xxx), чтобы отправлять тестовые запросы в один клик.
Область применения: Эта страница предназначена для редактирования изображений. Вы должны предоставить входное изображение (закодированное в base64) вместе с инструкциями по редактированию. Чтобы сгенерировать новое изображение только по тексту, используйте эндпоинт Text-to-Image.
🖥️ Ограничение браузерной песочницы (важно)Этот эндпоинт возвращает изображение, закодированное в base64 (inlineData.data, обычно несколько MB), в ответе. Из-за ограничений рендеринга в браузере песочница справа может показать 请求时发生错误: unable to complete request после получения ответа — запрос на самом деле выполнен успешно; браузер просто не может отрендерить такую длинную строку base64.Рекомендуемый рабочий процесс (подходит для новичков):
  • Скопируйте приведенный ниже пример на Python / Node.js / cURL и запустите его локально. Код автоматически base64.b64decodes ответ и записывает изображение в файл.
  • Если вам все же нужно использовать встроенную в браузер песочницу, используйте крошечное референсное изображение (меньше 50KB), чтобы уменьшить размер ответа.
⚠️ Структура массива parts (важно — прочитайте это для правок с несколькими изображениями)Каждый part должен быть либо text, либо inlineData, но никогда не оба сразу. Это соответствует официальному контракту Google gemini-3.1-flash-lite-image.Правильно: одна текстовая часть (инструкция) + N частей inlineData (по одной на изображение):
Неправильно (каждая часть содержит и text, и inlineData — приводит к неопределенному поведению):
🖼️ О поле inlineData.dataЭтот эндпоинт использует формат JSON (а не загрузку файлов через multipart), поэтому в Playground нельзя напрямую выбрать локальные файлы. Сначала нужно преобразовать изображение в строку Base64, а затем вставить ее в поле data.Однострочная команда: преобразовать + скопировать в буфер обмена:
После выполнения просто Cmd+V / Ctrl+V вставьте в поле data в Playground. Также не забудьте установить mimeType в соответствующий image/jpeg или image/png.Рекомендация: Для тестирования используйте небольшие изображения (меньше 200KB), чтобы избежать задержек в браузере из-за длинных строк base64. Для частых тестов редактирования изображений лучше использовать приведенные ниже примеры кода и запускать их локально.

Примеры кода

Python

Node.js

cURL

Редактирование нескольких изображений

При объединении или сравнении нескольких входных изображений используйте одну часть text (инструкцию), за которой следуют несколько частей inlineData (по одной на каждое изображение).

Python (несколько изображений)

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

Многоходовое редактирование в диалоге

Nano Banana 2 Lite (gemini-3.1-flash-lite-image) поддерживает многоходовое редактирование в диалоге: добавляйте сгенерированное изображение каждого хода обратно в contents как role: "model" inlineData, затем отправляйте следующую инструкцию пользователя. Модель редактирует на основе полной истории разговора и накапливает изменения (например, сначала перекрасьте диван, затем добавьте аксессуар — предыдущее изменение сохраняется).
Начните многоходовое редактирование с существующего изображения: поместите inlineData (ваше собственное изображение) и инструкцию в первое сообщение пользователя, чтобы отредактировать существующую фотографию, затем на каждом ходе продолжайте подставлять вывод модели в contents.

Авторизации

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

API Key obtained from the APIYI console

Тело

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

Content array containing the edit instruction and the image(s) to edit

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

Ответ

Image generated successfully

candidates
object[]

Array of generation results

usageMetadata
object