x402 AI Üretim API'si: Hesap Olmadan Çağrı Başına Ödeme

x402, HTTP 402 durum kodunu işlevsel bir ödeme duvarına dönüştüren açık bir protokoldür: sunucu bir isteğe 402 Payment Required ve makine tarafından okunabilir ödeme koşullarıyla yanıt verir, istemci stabil kripto para transfer yetkisini imzalar, isteği yineler ve sonucunu alır. Hesap yok, API anahtarı yok, aylık abonelik yok. Coinbase protokolü Nisan 2026'da Linux Foundation'a devretti ve x402 Foundation faaliyete geçtiğinde, aralarında AWS, Google, Stripe, Visa ve Mastercard'ın da bulunduğu 40 üye kuruluşa ulaştı. Bu artık bir deney olmaktan çıktı.

Hızlı yanıt: BananaBanana'nın x402 uç noktası https://bananabanana.pro/api/x402 adresindedir. { "tool": "...", "arguments": {...} } gövdesiyle bir POST gönderin, bu parametreler için kesin fiyatı içeren bir 402 yanıtı alın, Base ağında USDC ile ödeyin ve isteği tekrarlayın. Görseller $0.03'ten, video $0.30'dan, seslendirme her 200 karakter için $0.01'den başlar. Görsel ve ses için yalnızca dosya başarıyla oluşturulursa ücret tahsil edilir.

Son cümle, x402 hakkındaki çoğu yazının atladığı kısımdır ve bu yüzden üzerinde duracağız. Ücret almak kolaydır; başarısız olan çağrılardan ücret almamak ise mimari tasarımın asıl önemli olduğu yerdir.

Ödeme pratikte nasıl gerçekleşir?

Yalnızca dört adım vardır ve HTTP istemciniz bunlardan üçünü otomatik olarak halleder:

1. Ajanınız normal bir JSON POST isteği gönderir. Ödeme başlığı yoktur.
2. Sunucu, bir accepts dizisi içeren 402 yanıtı döner. Ödeme gereksinimi atomik birimler cinsinden tutarı, alıcı adresini, USDC sözleşmesini, zinciri ve geçerlilik süresini belirtir.
3. İstemci bu tutar için bir EIP-3009 transfer yetkisi imzalar ve bunu X-PAYMENT başlığında Base64 olarak kodlar.
4. Aynı istek bu başlıkla yeniden gönderilir. Sunucu imzayı doğrulama için kolaylaştırıcıya (facilitator) iletir, üretimi gerçekleştirir ve ardından zincir üzerinde takas işlemini başlatır.

İmza bir blokzincir işlemi değildir; ağa gönderilene kadar gerçek bir transfere dönüşmeyen zincir dışı bir yetkilendirmedir. Bu da iki aşamalı tasarımı mümkün kılar: önce doğrula, sonra üret, en son takas et.

Pratik bir detay: v2 spesifikasyonu başlıkları PAYMENT-SIGNATURE ve PAYMENT-RESPONSE olarak yeniden adlandırır, ancak mevcut istemcilerin çoğu hala X-PAYMENT göndermektedir ve biz bunu kabul ediyoruz. Resmi TypeScript SDK'sını kullanıyorsanız bu ayrım sizin için şeffaftır.

Bir çağrının maliyeti nedir?

Fiyatlar üretim başına hesaplanır ve herhangi bir şey imzalamadan önce belirtilir. Kesin tutar parametrelere bağlıdır (4K bir görsel 1K'dan farklı fiyatlandırılır), bu nedenle 402 yanıtı sizin özel isteğinizi fiyatlandırır.

Omni'de sesli üç saniyelik bir klip $0.30 tutar. Listedeki en uygun fiyatlı gerçek video seçeneğidir. Veo daha yüksek netlik sunar, ancak 8 saniye 1080p sesli bir video için maliyet taslak amacıyla kullanıldığında belirgin şekilde artar.

Güncel kataloğu doğrudan inceleyin: GET https://bananabanana.pro/api/x402 ödeme gerektirmeden tüm fiyat listesini ücretsiz olarak döner.

Baştan sona iki istek

İmzalama adımı hariç (bu kısmı x402 istemci kütüphaneniz üstlenir), curl ile tam akış şöyledir:

# 1. Fiyat teklifi isteği. Ödeme başlığı yok: fiyat dökümünü alın.
curl -s -X POST https://bananabanana.pro/api/x402 \
  -H 'Content-Type: application/json' \
  -d '{"tool":"generate_image","arguments":{"prompt":"a paper boat on still water at dawn","model":"nano-banana-pro","resolution":"2048"}}'

{
  "x402Version": 1,
  "error": "Payment required: $0.11 for generate_image.",
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "maxAmountRequired": "110000",
    "resource": "https://bananabanana.pro/api/x402",
    "payTo": "0x7c0e9abd1c48380e27ab5bfced1be54f23ce773f",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "maxTimeoutSeconds": 300,
    "extra": { "name": "USD Coin", "version": "2" }
  }]
}

Bu parametreleri imzalayın, başlıkla yeniden gönderin; ikinci yanıt üretilen dosyayı iletir:

{
  "paid_usd": 0.11,
  "result": {
    "status": "completed",
    "images": [{ "url": "https://bananabanana.pro/api/files/..." }]
  }
}

x402 sunucusu geliştirenler için iki önemli detay: maxAmountRequired atomik birimler cinsindendir. USDC 6 ondalık basamağa sahiptir, bu nedenle $0.11 değeri 110000 olur. Ayrıca extra.name, USDC sözleşmesinin name() fonksiyonunun döndürdüğü değerle birebir eşleşmelidir (Base mainnet üzerinde USD Coin, Base Sepolia üzerinde USDC). Bu değer EIP-712 domain separator hesabında kullanılır ve uyuşmazlık durumunda imza doğrulaması sessizce başarısız olur.

Videoda farklılık: ön ödeme ve başarısızlıkta iade jetonu

Görseller ve ses, HTTP isteğinin süresi içinde tamamlanır (doğrula → üret → takas et). Yalnızca dosya başarıyla oluşturulursa tahsilat yapılır. Güvenlik filtresi reddi veya zaman aşımı durumunda imza zincire gönderilmez ve hiçbir ücret ödemezsiniz.

Video farklı çalışır: Veo veya Omni'de bir render işlemi bir ila on dakika sürer, bir HTTP bağlantısını bu kadar süre açık tutmak mümkün değildir ve Google tarafında başlatılan işlem iptal edilemez (onların interactions.cancel metodu 501 UNIMPLEMENTED döner). Bu nedenle videoda ödeme başta takas edilir, bir job_id döner ve sonuç ücretsiz bir uç noktadan sorgulanır.

Ödemesi yapılmış bir video moderasyon tarafından reddedilirse ne olur?

bb_rf_… formatında 90 gün geçerli tam tutarda bir iade jetonu (refund token) alırsınız ve bunu sonraki herhangi bir çağrıda refund_token parametresiyle kullanabilirsiniz. $1.30 ödediğiniz bir video filtreye takılırsa, bir sonraki çağrınız $1.30 daha ucuza gelir. Yeni işlem tutarı jeton bakiyesinden azsa, kalan fark yeni bir jeton olarak iade edilir.

Bu işlem zincir üzerinde bir USDC iadesi değildir; bunu açıkça belirtiyoruz. Sunucumuz özel anahtar barındırmaz ve dışarıya transfer başlatamaz, yalnızca gelen ödemeleri kabul eder veya reddeder. Bir x402 servisinin güvenliği açısından sunucuda özel anahtar bulunmaması önemli bir korumadır.

Bu video söz konusu uç nokta üzerinden $0.30 karşılığında üretildi: Gemini Omni Flash modeli, 3 saniye süre, yumuşak yan aydınlatmalı cam bir tankta su içinde yayılan mürekkep ve derinden gelen ortam sesi istemiyle hazırlandı. Ses doğrudan model tarafından üretilmiştir.

Bir ajan uç noktayı nasıl keşfeder?

Ajan doğrudan URL'yi biliyorsa keşif mekanizmasına gerek yoktur. Diğer ajanlar için servis /.well-known/x402 (ve /.well-known/x402.json) adresinde bir bildirim yayımlar.

Bildirim her aracı ayrı bir kaynak olarak ödeme gereksinimleri, CAIP-2 formatında zincir kimliği, ödeme adresi ve kolaylaştırıcı ile listeler. Bildirimin accepts bloğu tavan fiyat yerine aracın minimum fiyatını belirtir, böylece ajanın yanlışlıkla fazla ödeme yapması engellenir.

Dizinler ayrıca boş POST istekleriyle uç noktaları tarar. Sunucumuz bunlara araç kullanım talimatlarını içeren bir 402 ile yanıt verir.

x402 mi yoksa bir hesap mı?

Her iki yol da aynı üretim modellerine ulaşır. Ajanınızın mimarisine göre seçim yapabilirsiniz.

Bakiye yükleme bonusu belirgin bir avantajdır: Promosyon koduyla $100 yüklemek $120 bakiye sağlar (%17 efektif indirim), x402'de ise hesap bakiyesi tutulmadığı için bu geçerli değildir. Diğer taraftan, cüzdanı olan otonom bir ajanın e-postaya ihtiyacı yoktur ve tek bir istek döngüsünde üretime başlayabilir.

Hesapla çalışmayı tercih ederseniz, MCP sunucumuz Claude Code, Cursor ve VS Code'u destekler, web üreticisi ise doğrudan tarayıcınızda çalışır.

Sık Sorulan Sorular

Ödeme yapmak için bir Coinbase hesabına ihtiyacım var mı?

Hayır. Base ağında USDC bulunduran herhangi bir EVM cüzdanı yeterlidir. Takas işlemi kolaylaştırıcı tarafından yürütülür; onlara da kaydolmanız gerekmez.

Üretimim güvenlik filtresi tarafından engellenirse ne olur?

Görsel ve ses için hiçbir ücret tahsil edilmez: takas yalnızca dosya oluşturulduğunda gerçekleşir. Video için sonraki isteklerde geçerli tam tutarda bir iade jetonu alırsınız.

Hangi zincirler ve token'lar destekleniyor?

Base ana ağında (Base mainnet) USDC, exact şeması. /.well-known/x402 altındaki bildirim CAIP-2 zincir kimliğini ve token sözleşme adresini içerir.

x402 üzerinden ürettiğim bir videoyu düzenleyebilir miyim?

x402 üzerinden düzenleyemezsiniz. Düzenleme, bir hesaba bağlı üretimler üzerinden çalışır (MCP'de edit_video). x402 üzerinden istediğiniz zaman sıfırdan yeni video üretebilirsiniz.

Teklif edilen fiyat ne kadar süreyle geçerlidir?

İmzalama süresi varsayılan olarak 300 saniyedir (maxTimeoutSeconds). Temel fiyatlar sitedeki tarifelere uygundur ve seans süresince sabittir.

Canlı uç noktada $0.03'lık bir görsel üretimiyle deneyin. İstemciniz EIP-3009 yetkilendirmesini imzalayabiliyorsa, görselinizi almaya yalnızca dört satır kod uzaklıktasınız.