Документация

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

Вы можете отправить до 3 референсных изображений и текстовых запросов, возвращает изображение в формате OpenAI b64_json

POST
https://ai.wormsoft.ru/api/v1/images/generations/edits
* Используются те же API-ключи, что и для GPT-эндпоинтов.
Авторизация:
Bearer YOUR_API_KEY
Или заголовок:
x-api-key: YOUR_API_KEY
Поддерживаемые модели
Qwen Image Edit (qwen_image_edit_2511)
Qwen Image 2.1 Edit (qwen_image_2_1_edit)
GPT Image 2.5 (gpt_image_2_5)
GPT Image (gpt_image)

Лимиты загрузки

  • До 3 изображений за запрос
  • До 25 МБ на файл

Структура запроса

  • Content-Type: multipart/form-data (как у OpenAI /v1/images/edits).
  • images — массив файлов (1–3 изображения), поле images.
  • prompt — обязательный, описание изменений.
  • model — обязательный, идентификатор модели (enum).

Минимальный пример запроса

curl --request POST \
  --url https://ai.wormsoft.ru/api/v1/images/generations/edits \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --form 'model=qwen_image_edit_2511' \
  --form 'prompt=change background to space' \
  --form 'images=@photo1.png' \
  --form 'images=@photo2.png'

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

200 OK с JSON-телом. Формат идентичен генерации — изображение в base64.

{
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }
  ]
}

Тарифы

  • Стоимость редактирования зависит от модели: qwen_image_edit_2511 — 10 000, qwen_image_2_1_edit — 20 000, gpt_image_2_5 — 500 000, gpt_image — 100 000 кредитов за запрос. Списание происходит только после успешного редактирования.

Как работают референс-изображения

  • Изображения передаются в поле images по очереди: в промпте на них можно ссылаться как «первое изображение», «второе» и т.д.
  • Лимит по API — до 3 файлов за запрос; GPT Image и GPT Image 2.5 принимают одно изображение.

Ошибки и лимиты

400
Неверный запрос пользователя
401
Неверный или отсутствует API ключ
402
Недостаточно кредитов на балансе
429
Превышен лимит запросов (rate limit)
500+
Ошибка на стороне нашего сервиса
Редактирование обычно занимает 1–3 минуты; максимальное ожидание ответа — до 10 минут.

Отслеживание прогресса

  • В личном кабинете можно получать информацию о ходе обработки изображения в реальном времени через SSE: POST /api/lk/images/edit/stream
  • Во время обработки сервер отправляет два типа событий: progress и done.