API
Документация REST API сервиса SigCleaner.
Метод: удаление фона
POST https://sigclean.io/api/remove
Авторизация
Authorization: Bearer YOUR_API_KEY
Параметры запроса
| Параметр | Тип | Обязателен | Описание |
|---|---|---|---|
file |
multipart file | Один из двух | PNG, JPG или PDF изображение |
url |
string | Один из двух | Прямая ссылка на изображение |
type |
string | Нет | json (по умолчанию) — вернуть JSON со ссылкойfile — вернуть бинарный файл (WebP) |
Ответ: type=json
{
"status": "ok",
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"url": "https://sigclean.io/api/file/550e8400-e29b-41d4-a716-446655440000"
}
Ответ: type=file
Возвращает бинарный файл WebP с заголовком
Content-Type: image/webp.
Пример cURL
curl -X POST https://sigclean.io/api/remove \
-H "Authorization: Bearer YOUR_KEY" \
-F "file=@stamp.jpg" \
-F "type=json"
Скачать результат
GET https://sigclean.io/api/file/{uuid}
Метод: список файлов
GET https://sigclean.io/api/files
Возвращает список всех успешно обработанных файлов, принадлежащих текущему пользователю. Файлы доступны по ссылке /api/file/{uuid}.
Авторизация
Bearer-токен или активная сессия (cookie). Без авторизации возвращает 401.
Authorization: Bearer YOUR_API_KEY
Ответ
{
"status": "ok",
"files": [
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"url": "https://sigclean.io/api/file/550e8400-e29b-41d4-a716-446655440000",
"created_at": "2026-07-01T10:00:00Z",
"expires_at": "2027-07-01T10:00:00Z"
}
]
}
| Поле | Тип | Описание |
|---|---|---|
uuid |
string | Уникальный идентификатор файла |
url |
string | Прямая ссылка для скачивания файла (WebP) |
created_at |
string (ISO 8601) | Дата и время создания файла (UTC) |
expires_at |
string | null | Дата истечения хранения (UTC). null — файл хранится бессрочно (авторизованные пользователи). Для гостей — created_at + 1 год. |
Пример cURL
curl https://sigclean.io/api/files \
-H "Authorization: Bearer YOUR_KEY"
Управление ключами API
Для управления ключами необходимо войти в аккаунт.