Skip to main content
POST
Используйте этот маршрут, чтобы редактировать существующие изображения с помощью OpenAI-совместимой multipart-загрузки в CometAPI.

​
Используйте этот маршрут, когда

  • У вас уже есть исходное изображение, и вы хотите выполнить редактирование по Prompt
  • Вам может понадобиться маска для точечных изменений
  • Вы можете использовать multipart-загрузку файлов вместо обычного JSON-запроса

​
Безопасный первый запрос

  • Начните с одного файла PNG или JPG
  • Пропустите маску, пока не заработает базовый сценарий редактирования
  • Используйте model: "gpt-image-2" для запросов редактирования изображений GPT на этом маршруте
  • Используйте одну короткую инструкцию с просьбой внести одно видимое изменение
  • Считывайте отредактированный результат из data[0].b64_json
  • Установите output_format: "jpeg", если хотите получить JPEG payload
  • Ожидайте более высокой задержки, чем при обычной генерации изображений

​
Поведение модели

  • Модели редактирования изображений GPT на этом маршруте возвращают встроенные base64-данные изображения
  • output_format управляет типом закодированного изображения внутри b64_json
  • response_format имеет значение только тогда, когда модель поддерживает вывод URL
  • qwen-image-edit использует специфичное для провайдера поведение редактирования за тем же маршрутом CometAPI

Авторизации

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

Bearer token authentication. Use your CometAPI key.

Тело

multipart/form-data
​
image
file
обязательно

Source image file. Start with one PNG or JPG input for the simplest flow.

​
prompt
string
обязательно

Edit instruction describing the change you want.

Пример:

"Add a small red ribbon to the paper boat."

​
model
string
по умолчанию:gpt-image-2

The image editing model to use. Choose a supported model from the Models page.

​
mask
file

Optional PNG mask. Transparent areas mark the regions to edit. The mask dimensions must match the source image exactly.

​
n
string
по умолчанию:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Доступные опции:
high,
medium,
low
​
response_format
enum<string>

Requested response container when supported by the selected model. GPT image edit models return data[].b64_json; use output_format to choose the encoded image type.

Доступные опции:
url,
b64_json
​
output_format
string

Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.

Пример:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Ответ

200 - application/json

Edited image result.

​
created
integer
обязательно
​
usage
object
обязательно
​
data
object[]
обязательно
​
background
string

Background mode returned by models that expose it.

​
output_format
string

Encoded image type returned by GPT image models.

​
quality
string

Quality level returned by models that expose it.

​
size
string

Output size returned by models that expose it.