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

Загружает исходные изображения в виде multipart/form-data и редактирует их с помощью текстового запроса, совместимого с OpenAI client.images.edit(). Повторно использует конвейер изображения-изображения внутри себя; ответ всегда синхронизируется JSON. маска пока не поддерживается, а response_format поддерживает только URL-адреса (b64_json отклонен).

POST/api/v1/images/edits

Авторизация

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

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Тело

imageобязательно

file

Файл(ы) исходного изображения для редактирования. Повторите поле изображения (или используйте image[]) для нескольких файлов — до 8, 10 МБ каждый, MIME должен быть image/*.

≤ 8 files, ≤ 10 MB each, image/*

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

string

Текстовое описание редактирования, которое необходимо применить.

minLength: 1

Example: "change the background to a night city"

model

string

Модель редактирования изображения. Если этот параметр опущен, применяется значение сервера по умолчанию (в настоящее время gpt-5.4-image-2).

Example: "openai/gpt-5.4-image-2"

n

integer

Количество результатов для генерации: 1–10.

1–10

Example: 1

size

string

Выходной размер должен быть строкой пикселей «<ширина>x<высота>» (например, 1024x1024); значения в любом другом формате игнорируются.

format: <width>x<height>

Example: "1024x1024"

Подробное руководство →

POST /api/v1/images/edits

1
2
3
4
5
curl https://bazaarlink.ai/api/v1/images/edits \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -F model="openai/gpt-5.4-image-2" \
  -F image=@cat.png \
  -F prompt="change the background to a night city"

Примеры ответов

Успех. Всегда возвращает синхронизацию JSON (поток SSE очищается внутри) — совместимо с client.images.edit().

1
2
3
4
5
6
7
8
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ]
}