Перейти к основному содержимому

Документация

Центр обучения

Освойте модерацию контента с подробными руководствами, обучающими материалами и документацией API

Оплата за запрос с x402

Вы можете обращаться к Discuse API без аккаунта. Каждый запрос оплачивается в USDC в момент отправки с помощью платёжного протокола x402. Регистрация, API-ключ, тарифный план и месячная квота не нужны.

Используйте x402 для AI-агентов и нерегулярных запросов. Для стабильного трафика API-ключ на тарифном плане будет дешевле и даст более высокие лимиты.

Как работает оплачиваемый запрос?

  1. Отправьте запрос без заголовка X-API-Key.
  2. API отвечает 402 Payment Required. Заголовок ответа payment-required и JSON-тело описывают цену и принимаемые способы оплаты.
  3. Ваш x402-клиент подписывает платёж в USDC на эту сумму.
  4. Отправьте тот же запрос повторно, указав подписанный платёж в заголовке PAYMENT-SIGNATURE.
  5. Платёж проверяется и проводится, после чего API возвращает обычный ответ.

Любой клиент x402 версии 2 может выполнить шаги 2–4 за вас.

Как выглядит платёжный запрос?

{
  "x402Version": 2,
  "error": "PAYMENT-SIGNATURE header is required",
  "resource": {
    "url": "https://api.discuse.com/api/v2/scan",
    "description": "File virus scan"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "10000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x66Bd239CC81664622BD8d528aa8c14f9FE46e36c",
      "maxTimeoutSeconds": 60,
      "extra": { "assetTransferMethod": "permit2", "name": "USD Coin", "version": "2" }
    }
  ]
}

amount указывается в атомарных единицах USDC (6 знаков после запятой), поэтому 10000 — это $0.01. accepts содержит по одной записи для каждой сети.

Какие сети и токены принимаются?

Сеть Chain id Токен
Base eip155:8453 USDC
Polygon eip155:137 USDC

Сколько стоит каждый запрос?

Endpoint Цена за запрос
POST /api/v2/check $0.005
POST /api/v2/scan $0.01
POST /api/v2/ocr $0.02
POST /api/v2/summarize $0.03
POST /api/v2/demo/check $0.005

Цена фиксирована для каждого запроса. Она не зависит от размера содержимого.

Какие лимиты применяются к оплачиваемым запросам?

Оплачиваемый запрос выполняет больше работы, чем покрывает его цена, если его не ограничивать, поэтому для оплачиваемых запросов лимиты ниже, чем для API-ключей:

Endpoint Лимит на оплачиваемый запрос
/api/v2/check Текст, а также не более 2 изображений или GIF, 1 документ и 5 ссылок. Видео недоступны.
/api/v2/scan 1 файл через file_url (до 50 MiB) или file_data (до 10 MiB)
/api/v2/ocr 1 файл
/api/v2/summarize Текст или 1 файл

Запрос сверх лимита отклоняется с кодом 400 и сообщением, которое начинается с x402 pay-per-request limit. Каждый платёжный кошелёк может отправлять до 60 запросов в минуту. При превышении этого лимита API отвечает 429.

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

Как не платить, если у меня есть API-ключ?

Отправляйте заголовок X-API-Key. Для запроса с этим заголовком оплата никогда не запрашивается: он списывается с вашего тарифного плана. Ключ в JSON-теле не учитывается: без заголовка запрос получит платёжный запрос.

Автор: Команда Discuse · Обновлено June 2026