Тариф Business · ≈ 2990 ₽/мес
Программный доступ к очистке
API нужен, если клиент встраивает PixClean в свой сайт, приложение, витрину или внутренний процесс: отправляет фото и маску запросом, получает готовый файл без ручной работы в браузере. На результате нет наших водяных знаков — только чистое изображение.
Как это работает
- Клиент оформляет тариф Business (на нём включён API; лимит порядка 5000 очисток в день).
- В кабинете на вкладке «API‑ключи» создаёт секретный ключ вида
px_…. - Его бэкенд вызывает
POST /api/v1/cleanс заголовкомAuthorization: Bearer px_…, передаёт изображение и маску (области для затирания) в JSON. - В ответе —
jobIdи ссылка/данные результата. Опционально можно указатьwebhook_url— мы отправим POST на адрес клиента, когда задание завершится.
Пример запроса
POST https://clean.elvensong.ru/api/v1/clean
Authorization: Bearer px_ваш_ключ
Content-Type: application/json
{
"image": "data:image/png;base64,...",
"mask": "data:image/png;base64,...",
"quality": "medium",
"format": "png",
"webhook_url": "https://ваш-сайт.ru/hook"
}Файлы на сервере хранятся около 1 часа, затем удаляются. Ключ нельзя светить во фронтенде — только на сервере клиента.
Если API купили у вас
- Убедитесь, что у покупателя активен тариф Business (иначе ключ вернёт 401).
- Попросите создать ключ в кабинете и хранить его в секретах (не в git, не в мобильном приложении).
- Дайте ссылку на эту страницу и пример запроса; при необходимости помогите с форматом маски (белое = область очистки).
- Расход идёт из дневного лимита Business; при исчерпании — 429 / отказ до следующего дня или апгрейд лимитов по договорённости.
- Ключ можно отозвать в кабинете, если его скомпрометировали — затем выпустить новый.