Russian Spam Classification API

Мощный инструмент для классификации русскоязычного спама с использованием модели NeuroSpaceX/ruSpamNS_v11

Начать работу

Начало работы

Russian Spam Classification API предоставляет простой интерфейс для анализа текста на русском языке и определения, является ли он спамом. API использует модель машинного обучения NeuroSpaceX/ruSpamNS_v11 для точной классификации текста.

Базовый URL

https://ru-spam.ru

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

Все запросы к API требуют токен авторизации, который должен быть передан в заголовке token. Чтобы получить токен, вам необходимо:

Приобретение API ключа

Для получения API ключа необходимо:

  1. Перейти в Telegram бот @ruSpamNS_bot
  2. Ввести команду /buy_token
  3. Следовать инструкциям по оплате
  4. После оплаты вы получите свой уникальный API ключ
Примечание: Стоимость использования API зависит от длины обрабатываемого текста. Текущая тарификация составляет 0.06 единиц за 128 токенов текста.

Конечные точки API

POST /classify

Классифицирует предоставленный текст и определяет, является ли он спамом.

Параметры запроса

Параметр Тип Обязательный Описание
text string Да Текст для анализа

Пример запроса (Python)

import requests
import json

url = "https://ru-spam.ru/classify"
headers = {
    "Content-Type": "application/json",
    "token": "YOUR_API_TOKEN_HERE"
}
data = {
    "text": "Срочно! Ваша карта заблокирована. Перейдите по ссылке, чтобы подтвердить личность и разблокировать карту."
}

response = requests.post(url, headers=headers, data=json.dumps(data))
result = response.json()
print(result)

Пример запроса (cURL)

curl -X POST "https://ru-spam.ru/classify" \
     -H "Content-Type: application/json" \
     -H "token: YOUR_API_TOKEN_HERE" \
     -d '{"text": "Срочно! Ваша карта заблокирована. Перейдите по ссылке, чтобы подтвердить личность и разблокировать карту."}'

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

{
    "is_spam": true,
    "confidence": 0.98765,
    "processing_time": 0.0832,
    "tokens_used": 0.125,
    "cost": 0.0075,
    "remaining_balance": 9.9925
}
Поле Тип Описание
is_spam boolean Результат классификации (true - спам, false - не спам)
confidence number Уверенность модели в классификации (от 0 до 1)
processing_time number Время обработки запроса в секундах
tokens_used number Количество использованных токенов
cost number Стоимость данного запроса
remaining_balance number Оставшийся баланс на вашем аккаунте
GET /stats

Получает статистику по использованию API для вашего токена.

Пример запроса (Python)

import requests

url = "https://ru-spam.ru/stats"
headers = {
    "token": "YOUR_API_TOKEN_HERE"
}

response = requests.get(url, headers=headers)
result = response.json()
print(result)

Пример запроса (cURL)

curl -X GET "https://ru-spam.ru/stats" \
     -H "token: YOUR_API_TOKEN_HERE"

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

{
    "total_messages": 152,
    "spam_messages": 37,
    "spam_percentage": 24.34
}
GET /health

Проверяет состояние API и доступность модели.

Пример запроса (Python)

import requests

url = "https://ru-spam.ru/health"
headers = {
    "token": "YOUR_API_TOKEN_HERE"
}

response = requests.get(url, headers=headers)
result = response.json()
print(result)

Пример запроса (cURL)

curl -X GET "https://ru-spam.ru/health" \
     -H "token: YOUR_API_TOKEN_HERE"

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

{
    "status": "ok",
    "model": "NeuroSpaceX/ruSpamNS_v11"
}

Коды ошибок

Код Описание
401 Отсутствует токен или токен недействителен
403 Недостаточно средств на балансе
422 Неверный формат запроса
500 Внутренняя ошибка сервера
Совет: При получении ошибки 403 (недостаточно средств), воспользуйтесь Telegram ботом @ruSpamNS_bot и выполните команду /recharge для пополнения баланса.

О модели

API использует модель NeuroSpaceX/ruSpamNS_v11, специально обученную для классификации русскоязычного спама. Модель показывает высокую точность (более 95%) при определении различных типов спама, включая:

Модель обучена на большом наборе данных, включающем реальные примеры спам-сообщений из различных источников.