API Generasi AI via x402: Bayar Per Panggilan, Tanpa Akun

x402 adalah protokol pembayaran terbuka yang mengubah kode status HTTP 402 menjadi paywall fungsional: server merespons permintaan dengan status 402 Payment Required beserta ketentuan pembayaran yang dapat dibaca mesin, klien menandatangani otorisasi transfer stablecoin, mengulangi permintaan, dan menerima hasilnya. Tanpa akun, tanpa kunci API, dan tanpa langganan bulanan. Coinbase menyerahkan protokol ini ke Linux Foundation pada April 2026, dan ketika x402 Foundation mulai beroperasi, anggotanya telah mencapai 40 organisasi termasuk AWS, Google, Stripe, Visa, dan Mastercard. Ini bukan lagi sekadar eksperimen semata.

Jawaban cepat: Endpoint x402 BananaBanana berada di https://bananabanana.pro/api/x402. Kirim POST dengan { "tool": "...", "arguments": {...} }, terima respons 402 dengan harga pasti untuk parameter tersebut, bayar menggunakan USDC di jaringan Base, lalu ulangi permintaan. Gambar mulai dari $0.03, video mulai dari $0.30, suara $0.01 per 200 karakter. Biaya gambar dan suara hanya dipotong jika file berhasil dibuat.

Kalimat terakhir tersebut adalah detail yang sering dilewatkan dalam ulasan x402, dan itulah yang akan kita bahas secara mendalam. Menagih pembayaran itu mudah; tidak menagih untuk panggilan yang gagal adalah bagian di mana arsitektur perangkat lunak menjadi sangat menarik.

Bagaimana pembayaran berlangsung secara nyata

Hanya empat langkah, dan tiga di antaranya ditangani secara otomatis oleh klien HTTP Anda:

1. Agen Anda mengirimkan permintaan POST JSON standar tanpa header pembayaran.
2. Server merespons 402 dengan larik accepts. Ketentuan pembayaran mencantumkan nominal dalam satuan atomik, alamat penerima, kontrak USDC, jaringan, dan masa berlaku.
3. Klien menandatangani otorisasi transfer EIP-3009 untuk jumlah tersebut dan mengenkodekannya dalam Base64 pada header X-PAYMENT.
4. Permintaan yang sama dikirim ulang dengan header tersebut. Server meneruskan tanda tangan ke fasilitator untuk diverifikasi, menjalankan proses pembuatan media, lalu meminta fasilitator menyelesaikan transaksi on-chain.

Tanda tangan bukanlah transaksi blockchain seketika. Ini adalah otorisasi off-chain yang baru berubah menjadi transfer nyata saat diserahkan ke jaringan. Mekanisme dua tahap ini memungkinkan alur: verifikasi dulu, buat konten kemudian, dan selesaikan transaksi di akhir.

Detail praktis: spesifikasi v2 mengubah nama header menjadi PAYMENT-SIGNATURE dan PAYMENT-RESPONSE, namun sebagian besar klien yang beroperasi saat ini masih mengirimkan X-PAYMENT, dan kami tetap mendukungnya. Jika Anda memakai SDK resmi TypeScript, transisi ini berlangsung mulus.

Berapa biaya untuk satu panggilan

Harga dihitung per generasi dan diinformasikan sebelum Anda menandatangani apa pun. Angka pasti bergantung pada parameter (gambar 4K berbeda harganya dengan 1K), sehingga respons 402 menilai permintaan spesifik Anda.

Klip tiga detik di Omni beserta audio membutuhkan biaya $0.30, menjadikannya pilihan video nyata paling terjangkau di daftar. Veo memberikan resolusi lebih tinggi, namun untuk video 8 detik 1080p dengan suara biayanya melonjak drastis untuk sekadar draf awal.

Periksa katalog tarif terkini secara langsung: GET https://bananabanana.pro/api/x402 mengembalikan seluruh daftar harga secara gratis tanpa perlu pembayaran.

Dua permintaan dari awal hingga selesai

Berikut siklus lengkap menggunakan curl, di luar langkah penandatanganan (yang dikerjakan oleh pustaka klien x402 Anda).

# 1. Minta penawaran harga. Tanpa header pembayaran: dapatkan rincian biaya.
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" }
  }]
}

Tandatangani parameter tersebut, kirim ulang dengan header yang sesuai, dan respons kedua akan mengirimkan file hasil pembuatan:

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

Dua aspek teknis penting bagi pengembang server x402: nilai maxAmountRequired menggunakan unit atomik. Karena USDC memiliki 6 desimal, nominal $0.11 ditulis sebagai 110000. Selain itu, extra.name harus sama persis dengan yang dikembalikan fungsi name() pada kontrak USDC (di Base mainnet adalah USD Coin, sedangkan di Base Sepolia adalah USDC), karena nilai ini digunakan untuk menghitung domain separator EIP-712. Jika tidak cocok, verifikasi tanda tangan akan gagal tanpa pesan galat yang jelas.

Video memiliki alur berbeda: bayar di awal, dapatkan token pengembalian jika gagal

Gambar dan suara selesai diproses dalam durasi satu permintaan HTTP (verifikasi → buat → selesaikan). Penagihan hanya terjadi jika file berhasil diproduksi. Jika terjadi penolakan oleh filter moderasi atau batas waktu habis, tanda tangan tidak diajukan ke blockchain dan Anda tidak dikenakan biaya.

Video bekerja berbeda: proses rendering di Veo atau Omni memakan waktu satu hingga sepuluh menit, koneksi HTTP tidak dapat dibiarkan menggantung, dan operasi yang sudah berjalan di Google tidak dapat dibatalkan (metode interactions.cancel mereka mengembalikan 501 UNIMPLEMENTED). Oleh karena itu, video diselesaikan pembayarannya di awal, mengembalikan job_id, dan hasilnya dipantau melalui endpoint gratis.

Apa yang terjadi jika klip video yang sudah dibayar ditolak oleh sistem moderasi?

Anda akan menerima token pengembalian dana (refund token) bernilai penuh (bb_rf_…), berlaku 90 hari, yang dapat digunakan pada panggilan berikutnya dengan menyertakannya di parameter refund_token. Jika Anda membayar $1.30 untuk klip yang terblokir filter, permintaan Anda berikutnya otomatis dipotong $1.30. Jika pesanan baru bernilai lebih kecil dari saldo token, sisa nominal dikembalikan dalam bentuk token baru.

Ini bukan pengembalian dana on-chain dalam USDC. Server kami tidak menyimpan kunci privat dan tidak dapat melakukan transfer keluar, hanya menerima atau menolak transaksi masuk. Bagi keamanan sistem x402, tidak menyimpan kunci privat di server adalah keunggulan proteksi yang nyata.

Video ini dibuat melalui endpoint x402 seharga $0.30: model Gemini Omni Flash, durasi 3 detik, prompt pengambilan gambar bersambung tinta yang larut dalam air di tangki kaca dengan pencahayaan samping lembut dan dengungan ruangan bernada rendah. Audio diproduksi langsung oleh model.

Bagaimana agen menemukan endpoint

Jika agen sudah mengetahui URL langsung, penemuan otomatis tidak diperlukan. Untuk agen lainnya, layanan ini mempublikasikan manifes di /.well-known/x402 (dan /.well-known/x402.json).

Manifes mencantumkan setiap alat sebagai sumber daya terpisah beserta persyaratan pembayaran, rantai jaringan standar CAIP-2, alamat penerima, dan fasilitator. Blok accepts dalam manifes mencantumkan tarif minimum alat, bukan pagu maksimalnya, untuk mencegah agen membayar nominal berlebih secara tidak sengaja.

Direktori agen juga memeriksa endpoint dengan mengirimkan permintaan POST kosong. Server kami merespons dengan 402 beserta panduan pemanggilan alat.

x402 atau akun pengguna?

Kedua opsi terhubung ke generator AI yang sama. Pilihlah sesuai arsitektur agen Anda.

Bonus isi ulang saldo memberikan keuntungan nyata: deposit $100 dengan kode promo menghasilkan saldo $120 (diskon efektif 17%), yang tidak tersedia di x402 karena ketiadaan akun. Di sisi lain, agen mandiri dengan dompet kripto tidak membutuhkan email dan dapat langsung memproduksi konten dalam satu putaran permintaan.

Jika Anda memilih sistem akun, server MCP kami kompatibel dengan Claude Code, Cursor, dan VS Code, serta generator web siap digunakan langsung di browser.

Pertanyaan yang Sering Diajukan

Apakah saya membutuhkan akun Coinbase untuk membayar?

Tidak. Dompet EVM mana pun yang memiliki saldo USDC di jaringan Base dapat digunakan. Penyelesaian transaksi ditangani oleh fasilitator tanpa perlu mendaftar ke mereka.

Apa yang terjadi jika permintaan saya terblokir oleh filter keamanan konten?

Untuk gambar dan suara, saldo Anda tidak terpotong karena transaksi hanya diselesaikan saat file berhasil dibuat. Untuk video, Anda menerima token pengembalian dana penuh untuk dipakai pada permintaan berikutnya.

Jaringan dan token apa saja yang didukung?

USDC di jaringan utama Base (Base mainnet), skema exact. Manifes pada /.well-known/x402 menyediakan CAIP-2 chain id dan alamat kontrak token.

Bisakah saya mengedit video yang dibuat melalui x402?

Tidak melalui x402. Pengeditan video memerlukan integrasi dengan riwayat akun (edit_video di MCP). Di x402, Anda dapat membuat video baru dari awal setiap saat.

Berapa lama penawaran harga berlaku?

Batas waktu penandatanganan adalah 300 detik secara default (maxTimeoutSeconds). Tarif dasar mengikuti harga resmi di situs web dan bersifat stabil.

Coba hasilkan gambar seharga $0.03 di endpoint aktif kami. Jika klien Anda dapat menandatangani otorisasi EIP-3009, Anda hanya butuh empat baris kode untuk mendapatkan gambar Anda.