使用 x402 按请求付费
你可以在没有账号的情况下调用 Discuse API。每个请求都会在发送时通过 x402 支付协议以 USDC 支付。无需注册、无需 API key、无需套餐,也没有每月配额。
x402 适合 AI 代理和偶尔调用的场景。对于稳定流量,使用套餐中的 API key 更便宜,且限额更高。
付费请求如何工作?
- 发送请求时不要携带
X-API-Key标头。 - API 返回
402 Payment Required。payment-required响应标头和 JSON 正文会说明价格以及可接受的付款方式。 - 你的 x402 客户端会为该金额签署一笔 USDC 付款。
- 带上已签署的付款,在
PAYMENT-SIGNATURE标头中再次发送相同请求。 - 付款会被验证并结算,随后 API 返回正常响应。
任何 x402 version 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 会按网络列出可用选项。
接受哪些网络和代币?
| Network | Chain id | Token |
|---|---|---|
| Base | eip155:8453 |
USDC |
| Polygon | eip155:137 |
USDC |
每个请求的费用是多少?
| Endpoint | Price per request |
|---|---|
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 key:
| Endpoint | Limit per paid request |
|---|---|
/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 key。
如果我有 API key,如何避免付费?
发送 X-API-Key 标头。带有该标头的请求永远不会被要求付款,而是计入你的套餐。JSON 正文中的 key 不算:如果没有这个标头,请求会收到付款挑战。