Оплата за запрос с x402
Вы можете обращаться к Discuse API без аккаунта. Каждый запрос оплачивается в USDC в момент отправки с помощью платёжного протокола x402. Регистрация, API-ключ, тарифный план и месячная квота не нужны.
Используйте x402 для AI-агентов и нерегулярных запросов. Для стабильного трафика API-ключ на тарифном плане будет дешевле и даст более высокие лимиты.
Как работает оплачиваемый запрос?
- Отправьте запрос без заголовка
X-API-Key. - API отвечает
402 Payment Required. Заголовок ответаpayment-requiredи JSON-тело описывают цену и принимаемые способы оплаты. - Ваш x402-клиент подписывает платёж в USDC на эту сумму.
- Отправьте тот же запрос повторно, указав подписанный платёж в заголовке
PAYMENT-SIGNATURE. - Платёж проверяется и проводится, после чего 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-теле не учитывается: без заголовка запрос получит платёжный запрос.