Yapay zekâ modelleri için x402 API: istek başına USDC ile ödeyin
RunAPI, çağrı başına fiyatlandırılan uç noktalarında x402 ödemelerini kabul eder. Ajan normal bir istek gönderir, 402 fiyat teklifini alır, cüzdanıyla imzalar ve sonucu alır. Hesap yok, API key yok, ön ödemeli kredi yok.
curl -i -X POST "https://runapi.ai/api/v1/z_image/text_to_image" \ -H 'Content-Type: application/json' \ --data @request.json # HTTP/2 402# PAYMENT-REQUIRED: <base64 JSON with accepts: scheme, network, asset, amount, payTo>- 155 x402 ile ödenebilen kaynak
- Base ödeme ağı
- USDC ödeme varlığı
- 0 gereken API key
İstekten sonuca dört adım
-
İsteği anahtarsız gönderin
API key ile göndereceğiniz JSON gövdesinin aynısını POST edin, ancak Authorization başlığını eklemeyin.
-
402 fiyat teklifini okuyun
RunAPI, tam tutarı, varlığı, ağı ve alıcıyı listeleyen bir PAYMENT-REQUIRED başlığıyla 402 döndürür. Teklif 300 saniye geçerlidir.
-
İmzalayın ve yeniden deneyin
x402 v2 istemciniz, ajan cüzdanıyla bir EIP-3009 yetkilendirmesi imzalar ve isteği PAYMENT-SIGNATURE başlığıyla yeniden gönderir.
-
Görevi sorgulayın
RunAPI ödemeyi tamamlar, görevi başlatır ve PAYMENT-RESPONSE makbuzu ile sonuç için bir poll_url içeren 200 yanıtı döndürür.
Ödemeden önce bilmeniz gerekenler
Kayıt yok, API anahtarı yok
Ödeme yapan cüzdan tek kimliktir. Hesap oluşturmanız, anahtar saklamanız veya bakiye yüklemeniz gerekmez.
Gas ücreti olmadan USDC ödemesi
Ödeyen bir EIP-3009 yetkilendirmesi imzalar ve transferi Coinbase CDP facilitator gönderir; cüzdanda ETH değil yalnızca USDC gerekir.
Sonucu alma
Medya görevlerinin çoğu eşzamansız tamamlanır. 200 yanıtı, salt okunur bir görev erişim belirteci içeren bir poll_url barındırır. Belirteç yalnızca o görevi açar ve görev bittikten sonra 30 gün geçerli kalır.
Görev başarısız olursa
x402'de yerleşik bir iade mekanizması yoktur. Ücretli bir görev başarısız durumda sona erdiğinde RunAPI, aldığı tutarın tamamı için bir iade yükümlülüğü kaydeder; ardından bir operatör bu tutarı ayrı bir USDC transferiyle ödeyen cüzdana geri gönderir. İade otomatik değildir.
Hangi uç noktalar uygundur
x402, çağrı başına sabit fiyatlı REST uç noktalarında çalışır. LLM uç noktaları dahil olmak üzere token, saniye veya karakter başına ücretlendirilen modeller hâlâ API key ve kredi gerektirir. MCP sunucusu x402 ödemesi kabul etmez.
API key'ler çalışmaya devam eder
x402 ek bir ödeme yoludur. Geçerli bir API key gönderen istekler hesap kredilerini eskisi gibi kullanmaya devam eder; geçersiz anahtarlı bir istek ise ödeme teklifi yerine 401 alır.
Alışveriş nasıl görünür
Yanıtı, ajan cüzdanına bağlı herhangi bir x402 v2 istemcisine verin. İmzalama ve yeniden denemeyi istemci üstlenir:
request = {method: "POST", url: task_url, json: payload}response = x402_client.send(request, wallet: agent_wallet)# The x402 v2 client reads PAYMENT-REQUIRED, signs an EIP-3009# authorization, and replays the request with PAYMENT-SIGNATURE.response.status # => 200response.headers["PAYMENT-RESPONSE"] # settlement receiptresponse.json["poll_url"] # read-only task result URLÖrnek fiyatlar
Bugün x402 kabul eden bazı modellerin çağrı başına en düşük fiyatı. Fiyatlar canlı katalogdan gelir ve her 402 teklifi o isteğin tam tutarını belirtir.
| Model | Uç nokta | Çağrı başına fiyat |
|---|---|---|
| Z Image Text to image z-image | POST /api/v1/z_image/text_to_image | $0.01 |
| Flux Text to image flux-2-klein | POST /api/v1/flux/text_to_image | $0.03 |
| Suno Stitch audio suno-v4 | POST /api/v1/suno/stitch_audio | $0.01 |
| Suno Stitch audio suno-v4.5 | POST /api/v1/suno/stitch_audio | $0.01 |
| Recraft Upscale image recraft-crisp-upscale | POST /api/v1/recraft/upscale_image | $0.01 |
| Recraft Remove background recraft-remove-background | POST /api/v1/recraft/remove_background | $0.01 |
Ödeme ayrıntıları
RunAPI, x402 v2 exact şemasını izler ve yalnızca aşağıdaki değerleri kabul eder. Diğer her şey, RunAPI facilitator'dan ödemeyi tamamlamasını istemeden önce reddedilir.
| Ağ | Base mainnet (eip155:8453) |
|---|---|
| Varlık | USDC, sözleşme 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 ondalık basamak |
| Facilitator | Coinbase CDP |
| Yetkilendirme | EIP-3009; ödeyenin USDC'ye ihtiyacı vardır, gas için ETH gerekmez |
| Limit | istek başına en fazla 10 USDC; teklifler 300 saniye sonra geçersiz olur |
x402 SSS
x402 nedir?
x402, HTTP 402 Payment Required durum kodu üzerine kurulu açık bir ödeme protokolüdür. Sunucu ödeme gereksinimleriyle 402 döndürür, istemci imzalı bir stablecoin yetkilendirmesiyle öder ve istek yeniden gönderilir. Protokolün bakımını x402 Foundation üstlenir.
x402 ile ödemek için RunAPI hesabı gerekir mi?
Hayır. Kimlik, ödemeyi yapan cüzdandır. RunAPI yalnızca ilk başarılı ödemeden sonra dahili bir cüzdan profili oluşturur ve hiçbir zaman e-posta veya API key istemez.
x402 facilitator ne işe yarar?
Facilitator, imzalı ödemeyi doğrular ve USDC transferini Base üzerinde gönderir. RunAPI, Coinbase CDP facilitator'ı kullanır; bu nedenle ödeyenin gas ücreti ödemesi gerekmez.
Bir isteğin maliyeti nedir?
Her uç noktanın çağrı başına sabit bir fiyatı vardır. 402 teklifi, imzalamadan önce tam USDC tutarını gösterir; güncel fiyatlar model kataloğunda listelenir.
Ajanlar RunAPI'yi x402 Bazaar üzerinden keşfedebilir mi?
Her 402 teklifi, girdi şemasını ve bir örneği içeren bir Bazaar keşif bildirimi taşır; böylece x402 istemcileri ve dizinleri uç noktayı listeleyebilir.
Ödeme yaptıktan sonra istek görev başlamadan başarısız olursa ne olur?
Doğrulamadan geçemeyen bir istek, ödeme tamamlanmadan reddedilir; dolayısıyla hiçbir ücret alınmaz. Ödeme tamamlandıktan sonra başarısız olan bir görev için tam iade yükümlülüğü oluşturulur.
İlgili sayfalar
Ajanınız kendi API çağrılarının ücretini ödesin
Modellere göz atın, çağrı başına fiyatlı bir uç nokta seçin ve ilk isteğinizi anahtarsız gönderin.