Ana içeriğe geç

Dokümantasyon

ÖĞRENME MERKEZİ

Kapsamlı rehberler, eğitimler ve API dokümantasyonuyla içerik moderasyonunda uzmanlaşın

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?

  1. İsteği X-API-Key başlığı olmadan gönderin.
  2. API 402 Payment Required yanıtını verir. payment-required yanıt başlığı ve JSON gövdesi fiyatı ve kabul edilen ödemeleri açıklar.
  3. x402 istemciniz bu tutar için bir USDC ödemesini imzalar.
  4. Aynı isteği, imzalanmış ödemeyle birlikte PAYMENT-SIGNATURE başlığında tekrar gönderin.
  5. Ö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.

Discuse Ekibi tarafından yazıldı · Son güncelleme June 2026