Перейти к основному содержанию
POST
Image Editing: Edit an existing image with text instructions
Интерактивная площадка Playground справа поддерживает выбор параметров из раскрывающихся списков. Введите свой API-ключ в поле Authorization (формат: Bearer sk-xxx), чтобы отправить тестовые запросы одним нажатием.
Область применения: эта страница посвящена редактированию изображений. Необходимо передать исходное изображение (в кодировке base64) вместе с инструкциями по редактированию. Чтобы создать новое изображение только по тексту, используйте эндпоинт преобразования текста в изображение.
🖥️ Ограничение браузерной площадки Playground (важно)Этот эндпоинт возвращает изображение в кодировке base64 (inlineData.data, обычно несколько МБ) в ответе. Из-за ограничений отображения в браузере площадка Playground справа может показать 请求时发生错误: unable to complete request после получения ответа — запрос при этом успешно выполнен; браузер просто не может отобразить такую длинную строку base64.Рекомендуемый порядок действий (подходит начинающим):
  • Скопируйте пример для Python / Node.js / cURL ниже и запустите его локально. Код автоматически обрабатывает ответ с помощью base64.b64decode и записывает изображение в файл.
  • Если необходимо использовать площадку Playground в браузере, возьмите небольшое исходное изображение (< 50KB) и установите для imageSize минимальный уровень (например, 1K).
⚠️ Структура массива parts (важно — прочитайте перед редактированием нескольких изображений)Каждый part должен содержать либо text, либо inlineData, но не оба варианта одновременно. Это соответствует контракту официального API Google gemini-3-pro-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 (несколько изображений)

cURL (несколько изображений, соответствует официальному формату Google)

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

Nano Banana Pro поддерживает редактирование нескольких изображений: вы можете загружать несколько изображений вместе с инструкциями по редактированию для расширенных возможностей, таких как композиция из нескольких изображений и перенос стиля.

Авторизации

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

API Key from APIYI Console

Тело

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

Content array with edit instructions and image to edit

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

Ответ

Image edited successfully

candidates
object[]

Generated results array

usageMetadata
object