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?
- Kirim permintaan tanpa header
X-API-Key. - API menjawab
402 Payment Required. Header responspayment-requireddan body JSON menjelaskan harga serta metode pembayaran yang diterima. - Klien x402 Anda menandatangani pembayaran USDC untuk jumlah tersebut.
- Kirim permintaan yang sama lagi dengan pembayaran yang sudah ditandatangani di header
PAYMENT-SIGNATURE. - 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.