Lewati ke konten utama

Dokumentasi

Pusat Pembelajaran

Kuasai moderasi konten dengan panduan lengkap, tutorial, dan dokumentasi API

Bayar per Permintaan dengan x402

Anda dapat memanggil API Discuse tanpa akun. Setiap permintaan dibayar dalam USDC saat Anda mengirimkannya, dengan protokol pembayaran x402. Tidak perlu mendaftar, tidak ada kunci API, tidak ada paket, dan tidak ada kuota bulanan.

Gunakan x402 untuk agen AI dan pemanggil sesekali. Untuk trafik yang stabil, kunci API pada sebuah paket lebih murah dan memiliki batas yang lebih tinggi.

Bagaimana cara kerja permintaan berbayar?

  1. Kirim permintaan tanpa header X-API-Key.
  2. API menjawab 402 Payment Required. Header respons payment-required dan body JSON menjelaskan harga serta metode pembayaran yang diterima.
  3. Klien x402 Anda menandatangani pembayaran USDC untuk jumlah tersebut.
  4. Kirim permintaan yang sama lagi dengan pembayaran yang sudah ditandatangani di header PAYMENT-SIGNATURE.
  5. Pembayaran diverifikasi dan diselesaikan, lalu API mengembalikan respons normal.

Klien x402 versi 2 mana pun dapat melakukan langkah 2 hingga 4 untuk Anda.

Seperti apa bentuk tantangan pembayarannya?

{
  "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 dinyatakan dalam unit atomik USDC (6 desimal), jadi 10000 berarti $0.01. accepts mencantumkan satu entri per jaringan.

Jaringan dan token apa saja yang diterima?

Jaringan ID chain Token
Base eip155:8453 USDC
Polygon eip155:137 USDC

Berapa biaya untuk setiap permintaan?

Endpoint Harga per permintaan
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

Harga ditetapkan per permintaan. Harga tidak bergantung pada ukuran konten.

Batas apa yang berlaku untuk permintaan berbayar?

Permintaan berbayar dapat memproses lebih banyak pekerjaan daripada yang tercakup oleh harganya jika tidak dibatasi, sehingga permintaan berbayar memiliki batas yang lebih kecil daripada kunci API:

Endpoint Batas per permintaan berbayar
/api/v2/check Teks, ditambah maksimal 2 gambar atau GIF, 1 dokumen, dan 5 tautan. Video tidak tersedia.
/api/v2/scan 1 file, melalui file_url (hingga 50 MiB) atau file_data (hingga 10 MiB)
/api/v2/ocr 1 file
/api/v2/summarize Teks, atau 1 file

Permintaan yang melebihi batas akan ditolak dengan 400 dan pesan yang diawali dengan x402 pay-per-request limit. Setiap dompet yang membayar dapat mengirim hingga 60 permintaan per menit. Di atas itu, API menjawab 429.

Permintaan berbayar menggunakan pengaturan moderasi default. Pengaturan proyek, seperti ambang khusus, memerlukan kunci API.

Bagaimana cara menghindari pembayaran jika saya memiliki kunci API?

Kirim header X-API-Key. Permintaan dengan header tersebut tidak akan pernah diminta melakukan pembayaran, dan sebagai gantinya akan ditagihkan ke paket Anda. Kunci di body JSON tidak dihitung: tanpa header, permintaan akan mendapatkan tantangan pembayaran.

Ditulis oleh Tim Discuse · Terakhir diperbarui June 2026