x402 ile İstek Başına Ödeme
Discuse API'yi hesap olmadan çağırabilirsiniz. Her istek, gönderdiğiniz anda x402 ödeme protokolüyle USDC olarak ödenir. Kayıt yok, API anahtarı yok, plan yok ve aylık kota yok.
AI aracıları ve ara sıra istek gönderenler için x402 kullanın. Düzenli trafik için bir plandaki API anahtarı daha ucuzdur ve daha yüksek limitler sunar.
Ücretli bir istek nasıl çalışır?
- İsteği
X-API-Keybaşlığı olmadan gönderin. - API
402 Payment Requiredyanıtını verir.payment-requiredyanıt başlığı ve JSON gövdesi fiyatı ve kabul edilen ödemeleri açıklar. - x402 istemciniz bu tutar için bir USDC ödemesini imzalar.
- Aynı isteği, imzalanmış ödemeyle birlikte
PAYMENT-SIGNATUREbaşlığında tekrar gönderin. - Ödeme doğrulanıp tamamlanır ve API normal yanıtı döndürür.
Herhangi bir x402 sürüm 2 istemcisi 2 ile 4 arasındaki adımları sizin için gerçekleştirebilir.
Ödeme talebi nasıl görünür?
{
"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 atomik birimlerindedir (6 ondalık), yani 10000 $0.01 eder. accepts her ağ için bir giriş listeler.
Hangi ağlar ve tokenlar kabul ediliyor?
| Ağ | Zincir kimliği | Token |
|---|---|---|
| Base | eip155:8453 |
USDC |
| Polygon | eip155:137 |
USDC |
Her isteğin maliyeti nedir?
| Uç nokta | İstek başına fiyat |
|---|---|
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 |
Fiyat istek başına sabittir. İçeriğin boyutuna bağlı değildir.
Ücretli isteklere hangi limitler uygulanır?
Ücretli bir istek, sınırlanmazsa fiyatının karşıladığından daha fazla iş yapar; bu nedenle ücretli isteklerin limitleri API anahtarlarına göre daha düşüktür:
| Uç nokta | Ücretli istek başına limit |
|---|---|
/api/v2/check |
Metin, ayrıca en fazla 2 resim veya GIF, 1 belge ve 5 bağlantı. Videolar kullanılamaz. |
/api/v2/scan |
file_url ile (en fazla 50 MiB) veya file_data ile (en fazla 10 MiB) 1 dosya |
/api/v2/ocr |
1 dosya |
/api/v2/summarize |
Metin veya 1 dosya |
Bir limiti aşan istek 400 ile ve x402 pay-per-request limit ile başlayan bir mesajla reddedilir. Ödeme yapan her cüzdan dakikada en fazla 60 istek gönderebilir. Bunun üzerinde API 429 yanıtını verir.
Ücretli istekler varsayılan moderasyon ayarlarını kullanır. Özel eşikler gibi proje ayarları için bir API anahtarı gerekir.
API anahtarım varken ödeme yapmaktan nasıl kaçınırım?
X-API-Key başlığını gönderin. Bu başlığa sahip bir istek için asla ödeme istenmez; bunun yerine planınıza yansıtılır. JSON gövdesindeki bir anahtar geçerli sayılmaz: başlık olmadan istek ödeme talebi alır.