Редактировать изображение

Редактирование изображений через API OpenAI Images Edits.

Создавайте отредактированные изображения по одному или нескольким входным изображениям и текстовому запросу; с помощью маски можно указать области для изменения.

POST/v1/images/edits

Создавайте отредактированные изображения по одному или нескольким входным изображениям и текстовому запросу. Если передана маска, её прозрачные области обозначают участки для редактирования; при редактировании нескольких изображений маска применяется к первому входному изображению.

Типы, размеры и количество входных файлов, правила маски, а также параметры качества и размеров зависят от выбранной модели. Используйте ID модели, доступной текущему ключу API и поддерживающей редактирование изображений.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

multipart/form-data

Передавайте изображения, текстовый запрос и необязательную маску в Multipart. Клиент должен позволять библиотеке запросов автоматически формировать boundary для Content-Type.

Определения типов TypeScript

Используйте тип request body в TypeScript.

image*|array<>

Одно или несколько изображений для редактирования. DALL·E 2 принимает квадратный PNG размером менее 4 MB; если mask не передан, изображение должно содержать прозрачные области. GPT-Image-1 принимает несколько изображений PNG, WEBP или JPG размером менее 25 MB каждое.

Фактически поддерживаемые форматы, размеры и количество файлов зависят от выбранной модели.

prompt*string

Желаемый результат редактирования. DALL·E 2 принимает до 1 000 символов, GPT-Image-1 — до 32 000; ограничения других моделей определяются их фактическими возможностями.

Длина1 <= length

mask?file

Необязательное изображение маски. Полностью прозрачные области обозначают участки для редактирования. Маска должна быть PNG размером менее 4 MB с такими же размерами, как у входного изображения; при нескольких изображениях она применяется к первому.

Форматbinary

model*string

ID модели для редактирования изображений. Выберите модель, доступную текущему ключу API и поддерживающую редактирование изображений.

Длина1 <= length

n?integer|null

Количество возвращаемых изображений: от 1 до 10; фактически поддерживаемое количество зависит от выбранной модели.

Диапазон1 <= value <= 10

По умолчанию1

quality?string|null

Качество изображения. GPT-Image-1 поддерживает high, medium, low; DALL·E 2 использует standard. Значение по умолчанию — auto.

По умолчанию"auto"

Допустимые значения

"auto"
"high"
"medium"
"low"
"standard"
null

response_format?string|null

Формат ответа с изображениями. url возвращает URL изображения, действительный в течение 60 минут после генерации; b64_json возвращает данные изображения в Base64.

По умолчанию"url"

Допустимые значения

"url"
"b64_json"
null

size?string|null

Размеры изображения. GPT-Image-1 поддерживает 1024x1024, 1536x1024, 1024x1536 и auto; DALL·E 2 — 256x256, 512x512, 1024x1024.

По умолчанию"1024x1024"

Допустимые значения

"256x256"
"512x512"
"1024x1024"
"1536x1024"
"1024x1536"
"auto"
null

user?string

Уникальный идентификатор конечного пользователя для мониторинга и обнаружения злоупотреблений.

Длина1 <= length

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/images/edits" \  -F model="MODEL_ID" \  -F image="otter.png" \  -F mask="mask.png" \  -F prompt="Милый маленький калан в берете" \  -F n="1" \  -F size="1024x1024"

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/edited-image-1.png"
    },
    {
      "url": "https://example.com/edited-image-2.png"
    }
  ]
}

Редактировать изображение

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`