Справочник API
Image Edits
Редактирование изображений
POST
/v1/images/editsРедактирует изображение по инструкции и входному файлу.
Когда использовать
- заменить часть изображения;
- изменить стиль;
- добавить или убрать объект;
- адаптировать изображение под формат.
Не загружайте изображения, если у вас нет права их обрабатывать.
Пример запроса
curl {{PUBLIC_API_BASE_URL}}/images/edits \
-H "Authorization: Bearer gw_live_..." \
-F model="provider/image-edit-model" \
-F image="@input.png" \
-F prompt="Сделай фон светлее и убери лишний текст"Параметры тела запроса
| Поле | Обязательность | Описание |
|---|---|---|
model | Да | Публичное имя модели редактирования. |
image | Да | Исходное изображение. |
prompt | Да | Инструкция по редактированию. |
mask | Нет | Маска области редактирования, если поддерживается. |
size | Нет | Размер результата. |
n | Нет | Количество вариантов. |
Поля ответа
| Поле | Обязательность | Описание |
|---|---|---|
created | Нет | Время создания. |
data | Да | Массив результатов. |
data[].url | Нет | Ссылка на результат. |
data[].b64_json | Нет | Результат в base64. |
data[].revised_prompt | Нет | Уточнённая инструкция, если доступна. |
Пример ответа
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}