API PixClean: когда подключать и как проверить за 10 минут

Кому нужен API

Если вы чистите 5 фото руками — хватит сайта. Если в CMS магазина по ночам грузятся сотни кадров — нужен [программный доступ](/docs/api).

Как устроено

1. Тариф Business.
2. В кабинете создаёте ключ `px_…`.
3. С своего сервера вызываете `POST /api/v1/clean` с `Authorization: Bearer …`, полями `image` и `mask` (data URL).
4. В ответе — `jobId` и готовый `output`.

Маска

Белым (или непрозрачным) отмечайте область, которую нужно затереть — как кистью в редакторе.

Безопасность

Ключ только в env бэкенда. Во фронт Next/Vue его класть нельзя: его украдут за минуту.

Лимиты

Списания идут из дневного лимита Business. При 401 проверьте тариф и что ключ не отозван.

Мини-чеклист запуска

• [ ] ключ создан и сохранён в секретах;
• [ ] тестовый запрос с маленьким PNG проходит;
• [ ] webhook (если нужен) отвечает 2xx;
• [ ] результат сохраняете у себя, не рассчитывая на час на нашем диске.