Перейти к содержанию

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

POST /openai/api/v1/images/edits редактирует изображения моделями GPT Image. Поля описаны в документации OpenAI Create image edit, модели — в каталоге.

Минимальный запрос с локальным PNG-файлом image.png:

curl https://hub.coreinfra.ai/openai/api/v1/images/edits \
-H "Authorization: Bearer $COREINFRA_API_KEY" \
-F 'model=gpt-image-1' \
-F 'prompt=Сделайте фон белым' \
-F 'image=@image.png;type=image/png'

Фрагмент ответа:

{"data":[{"b64_json":"…"}]}

Отличия от API OpenAI​

Хаб принимает JSON и multipart/form-data. Загрузки image и image[] преобразуются в images[]; загруженные mask и markup сохраняют назначение. Байты файлов преобразуются в base64 data URL. У загружаемого файла должен быть тип image/*.

В JSON изображения задаются через images[].image_url, маска и разметка — через mask.image_url и markup.image_url. Принимаются только данные в кодировке base64 (data:image/...;base64,...). Непустой file_id и ссылка на внешний ресурс отклоняются со статус-кодом 400; строковый адрес изображения в multipart проходит ту же проверку. Размер всего запроса ограничен общими лимитами.

Поля user и safety_identifier игнорируются. Параметр output_format: "svg" и модель glm-image в этом API методе отклоняются со статус-кодом 400.

Резерв учитывает текст, входные изображения и разметку, а также оценку выходных токенов по размеру и количеству изображений, включая частичные. Маска не входит в оценку входа. При size: auto или неизвестном размере используется оценка наибольшего изображения модели.

Списание идет по usage.input_tokens и usage.output_tokens. Цены находятся на «Тарифах», подробности — на странице «Стоимость генерации изображений».

Ошибки​

  • 400 — неверный JSON или multipart, недопустимое вложение, отсутствующая либо неподдерживаемая модель, output_format: "svg" или модель без поддержки редактирования (glm-image).
  • 502 — ошибка на стороне провайдера модели при выполнении запроса.

Формат ошибок приведен в разделе OpenAI API; общие ошибки авторизации, баланса и лимитов расходов описаны в общем справочнике.