API для разработчиков

Тот же движок, что работает на сайте и в тг боте, доступен по HTTP API — можно встроить обработку фото в свой бот, приложение или внутренний инструмент. Ключ выдаётся по запросу в поддержку.

RESTJSONHTTPSBearer-токен

01

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

Каждый запрос требует заголовок Authorization с API-ключом. Ключ привязан к аккаунту и не имеет срока действия, но может быть отозван при подозрении на злоупотребление.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

02

Эндпоинты

POST /v1/process

Отправляет изображение на обработку и возвращает идентификатор задачи.

curl -X POST https://api.razdevatorfoto.com/v1/process \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "mode=photo"

{
  "task_id": "tsk_8f21ac93",
  "status": "queued",
  "eta_seconds": 20
}

GET /v1/status/{task_id}

Возвращает текущий статус задачи и ссылку на результат, когда обработка завершена.

curl https://api.razdevatorfoto.com/v1/status/tsk_8f21ac93 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "task_id": "tsk_8f21ac93",
  "status": "done",
  "result_url": "https://cdn.razdevatorfoto.com/r/8f21ac93.jpg",
  "expires_at": "2026-08-15T21:40:00Z"
}

POST /v1/process-video

Аналог /v1/process для коротких видео — обработка занимает больше времени из-за покадрового анализа.

curl -X POST https://api.razdevatorfoto.com/v1/process-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]"

03

Лимиты и статус-коды

Базовый ключ ограничен 60 запросами в минуту на /v1/process. При превышении лимита API возвращает 429 Too Many Requests с заголовком Retry-After.

200 — успех 400 — неверный формат файла 401 — неверный ключ 429 — превышен лимит

04

Как получить ключ

API пока не в открытом доступе — доступ выдаётся точечно через поддержку. Напишите на [email protected] с описанием сценария использования, и мы пришлём тестовый ключ.

Прежде чем продолжить

Получение актуальной ссылки на бота

API для разработчиков

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

Эндпоинты

Лимиты и статус-коды

Как получить ключ

Не хотите интегрировать API?