跳到主要内容

文档

学习中心

通过完整指南、教程和 API 文档,掌握内容审核

使用 x402 按请求付费

你可以在没有账号的情况下调用 Discuse API。每个请求都会在发送时通过 x402 支付协议以 USDC 支付。无需注册、无需 API key、无需套餐,也没有每月配额。

x402 适合 AI 代理和偶尔调用的场景。对于稳定流量,使用套餐中的 API key 更便宜,且限额更高。

付费请求如何工作?

  1. 发送请求时不要携带 X-API-Key 标头。
  2. API 返回 402 Payment Required。payment-required 响应标头和 JSON 正文会说明价格以及可接受的付款方式。
  3. 你的 x402 客户端会为该金额签署一笔 USDC 付款。
  4. 带上已签署的付款,在 PAYMENT-SIGNATURE 标头中再次发送相同请求。
  5. 付款会被验证并结算,随后 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 不算:如果没有这个标头,请求会收到付款挑战。

由 Discuse 团队 撰写 · 最后更新于 June 2026