Skip to main content
Biarkan Sentra menulis kode integrasi untuk Anda.
Gunakan asisten AI kami di VS Code, Cursor, atau Windsurf untuk membuat kode SDK/API, kode integrasi LLM Blueprint, webhook, dan lainnya—cukup dengan menjelaskan kebutuhan Anda.
Coba Sentra: Integrasi Berbasis AI →
Dalam tutorial ini, Anda akan membangun aplikasi chat AI dengan penagihan berbasis penggunaan otomatis. Kita akan membuat semuanya dari awal: meter penagihan, konfigurasi produk, dan kode aplikasi yang menjalankan percakapan serta melacak penggunaan token secara real-time.
Tutorial ini menyediakan aplikasi lengkap yang dapat langsung digunakan, dengan backend dan frontend. Aplikasi chat menggunakan Google Gemini AI dan secara otomatis melacak penggunaan token tanpa memerlukan penghitungan manual.
Di akhir tutorial ini, Anda akan memiliki aplikasi chat yang:
  • Menjalankan percakapan AI menggunakan Google Gemini (AI SDK)
  • Melacak penggunaan token secara otomatis (tanpa kode manual)
  • Menagih pelanggan berdasarkan konsumsi token aktual
  • Menyertakan antarmuka chat yang menarik
AI Chat Demo

Apa yang Akan Kita Bangun

Mari kita mulai dengan memahami layanan chat AI kita:
  • Layanan: Chat berbasis AI menggunakan Google Gemini (AI SDK)
  • Model Harga: Bayar per token ($0.01 per 1.000 token)
  • Tingkat Gratis: 10.000 token gratis per pelanggan per bulan
  • Fitur: Riwayat percakapan, pelacakan token otomatis
Sebelum memulai, pastikan Anda memiliki:

Langkah 1: Buat Usage Meter Anda

Kita akan mulai dengan membuat meter di dashboard Dodo Payments untuk melacak penggunaan token AI.
Yang kita bangun: Meter bernama “AI Token Usage Meter” yang menjumlahkan semua token yang digunakan dalam percakapan chat.
1

Open the Meters section

  1. Masuk ke dashboard Dodo Payments
  2. Klik Products di sidebar kiri
  3. Klik Meters
  4. Klik tombol Create Meter
Create Meter
Anda akan melihat formulir untuk mengonfigurasi pelacakan token.
2

Fill in the basic meter information

Sekarang kita akan memasukkan detail khusus untuk layanan chat AI:Meter NameAI Token Usage MeterDescriptionTracks token consumption from AI chat conversations using AI SDKEvent Nameai_chat_usage
Nama event ai_chat_usage harus sama persis dengan yang nantinya kita kirim dari kode aplikasi. Nama event peka huruf besar-kecil!
3

Configure how we count tokens

Atur aggregation (cara meter menghitung event kita):Aggregation Type: Pilih Sum dari dropdownAggregate Over: Type → totalTokensMeasurement Unit: Type → tokens
Kita menggunakan “Sum” karena ingin menjumlahkan semua token yang digunakan dalam beberapa pesan chat. SDK secara otomatis mengirim totalTokens di setiap event.
4

Create your meter

  1. Periksa kembali apakah semua pengaturan sesuai dengan nilai di atas
  2. Klik Create Meter
Meter Configuration
Meter berhasil dibuat! “AI Token Usage Meter” Anda kini siap mulai menghitung token. Berikutnya, kita akan menghubungkannya ke produk penagihan.

Langkah 2: Dapatkan API Key Anda

Sebelum membuat aplikasi, mari kumpulkan API key yang diperlukan.
1

Get Dodo Payments API Key

  1. Di dashboard Dodo Payments, buka DevelopersAPI Keys
  2. Klik Create API Key
  3. Salin API key—formatnya akan terlihat seperti test_abc123...
Simpan API key ini—nanti kita akan menambahkannya ke file .env.
2

Get Google AI API Key

  1. Kunjungi aistudio.google.com
  2. Klik Get API Key
  3. Buat API key baru atau gunakan yang sudah ada
  4. Salin key tersebut
Simpan key ini dengan aman—kita juga akan menambahkannya ke file .env.

Langkah 3: Buat Produk Penagihan Anda

Sekarang kita perlu membuat produk yang menentukan harga ($0.01 per 1.000 token dengan 10.000 token gratis). Ini menghubungkan meter dengan penagihan aktual.
Yang kita bangun: Produk bernama “AI Chat Service” yang mengenakan biaya berdasarkan konsumsi token dengan tingkat gratis yang besar.
1

Navigate to Products

  1. Di dashboard Dodo Payments, klik Products di sidebar kiri
  2. Klik Create Product
  3. Pilih Usage-Based sebagai jenis produk
Ini memberi tahu Dodo Payments bahwa penagihan akan didasarkan pada penggunaan meter, bukan langganan tetap.
2

Enter product details

Isi detail yang diperlukan:Product Name: → AI Chat ServiceDescription: → AI-powered chat service with automatic token-based billingProduct Image: Unggah gambar yang relevan
Detail ini akan muncul pada invoice pelanggan, jadi buatlah dengan jelas dan profesional.
3

Connect your meter

Sebelum menghubungkan meter, pastikan Anda telah memilih Usage Based Billing sebagai jenis harga produk.Selain itu, atur Fixed Price ke 0 agar pelanggan hanya dikenai biaya berdasarkan penggunaan, tanpa biaya dasar.Sekarang, hubungkan meter yang baru saja Anda buat:
  1. Gulir ke bagian Associated Meter
  2. Klik Add Meters
  3. Dari dropdown, pilih “AI Token Usage Meter” (meter yang sebelumnya Anda buat)
  4. Pastikan meter tersebut muncul dalam konfigurasi produk
Meter Anda kini berhasil terhubung ke produk ini.
4

Set your pricing

Di sinilah kita menentukan model bisnis:Price Per Unit: Masukkan → 0.00001 (yaitu 0.01per1.000tokenatau0.01 per 1.000 token atau 0.00001 per token)Free Threshold: Masukkan → 10000 (pelanggan mendapatkan 10.000 token gratis per bulan)
Product Pricing
Cara kerja penagihan: Jika pelanggan menggunakan 25.000 token dalam sebulan, mereka akan ditagih untuk 15.000 token (25.000 - 10.000 gratis) = 15.000 × 0.00001=0.00001 = 0.15
5

Save your product

  1. Tinjau semua pengaturan:
    • Name: AI Chat Service
    • Meter: AI Token Usage Meter
    • Price: $0.01 per 1.000 token
    • Free tier: 10.000 token
  2. Klik Save Changes
Produk berhasil dibuat! Penagihan Anda kini telah dikonfigurasi. Pelanggan akan otomatis ditagih berdasarkan penggunaan token mereka.

Langkah 4: Lakukan Pembelian Uji Coba

Sebelum mulai membuat aplikasi, mari buat pelanggan uji coba dengan melakukan pembelian.
1

Get your payment link

  1. Di dashboard Dodo Payments, buka Products
  2. Temukan produk “AI Chat Service”
  3. Klik tombol Share di samping produk
  4. Salin payment link yang muncul
2

Complete a test purchase

  1. Buka payment link di tab browser baru
  2. Masukkan detail pembayaran uji coba dan selesaikan pembelian
Setelah pembayaran berhasil, Anda akan memiliki customer ID yang akan digunakan dalam kode aplikasi.
3

Find your customer ID

  1. Kembali ke dashboard Dodo Payments
  2. Buka Sales -> Customers di sidebar kiri
  3. Temukan pelanggan yang baru dibuat (dengan email uji coba)
  4. Salin customer ID—formatnya akan terlihat seperti cus_123
Simpan customer ID ini—kita akan menggunakannya saat menguji aplikasi chat.

Langkah 5: Bangun Aplikasi Chat

Kini konfigurasi penagihan telah selesai dan pelanggan uji coba telah dibuat. Mari bangun aplikasi chat AI dengan pelacakan token otomatis.
1

Set up your project

Buat direktori baru dan inisialisasi project:
2

Install dependencies

Instal package yang kita perlukan:
3

Configure TypeScript

Buat tsconfig.json:
tsconfig.json
Perbarui package.json untuk menambahkan module type dan scripts:
package.json
4

Create project structure

Buat folder dan file:
5

Set up environment variables

Buat file .env di root project Anda:
.env
Ganti nilai placeholder dengan API key aktual Anda dari Langkah 2.
6

Create the backend server

Buat src/server.ts dan salin kode server lengkap berikut:
Berikut server chat AI lengkap dengan penagihan terintegrasi:

Langkah 6: Tambahkan Antarmuka Chat

Sekarang mari tambahkan antarmuka chat yang menarik dengan riwayat percakapan lengkap! Buat public/index.html:
public/index.html

Langkah 7: Uji Aplikasi Chat Anda

Saatnya menguji aplikasi chat AI dan melihat penagihan berjalan! Pastikan semuanya berfungsi dari awal hingga akhir.
Yang kita uji: Kita akan melakukan beberapa percakapan dengan AI, memastikan event token sampai ke Dodo Payments, dan mengonfirmasi perhitungan penagihan sudah benar.
1

Start the server

Pertama, pastikan semuanya telah disiapkan:
  1. Pastikan file .env memiliki semua API key dari Langkah 2
  2. Jalankan development server:
Anda akan melihat:
Server sedang berjalan! Saatnya mengobrol.
2

Open the chat interface

  1. Buka browser Anda
  2. Buka http://localhost:3000
  3. Anda akan melihat antarmuka chat yang menarik
Pastikan Anda memperbarui CUSTOMER_ID di server.ts dengan customer ID uji coba aktual dari Langkah 4.
3

Have your first conversation

Mari kita uji! Coba pesan berikut:
  1. “Apa itu kecerdasan buatan?”
  2. “Bagaimana cara kerja machine learning?”
  3. “Bisakah Anda menjelaskan neural network?”
Perhatikan tampilan penggunaan token yang diperbarui setelah setiap respons!
Jika Anda melihat AI merespons dan jumlah token muncul, aplikasi Anda berfungsi!
4

Check your Dodo Payments dashboard

Sekarang mari pastikan event diterima:
  1. Buka dashboard Dodo Payments
  2. Buka Usage BillingAI Token Usage Meter
  3. Klik tab Events
  4. Anda akan melihat event chat yang tercantum
Yang perlu dicari:
  • Nama event: ai_chat_usage
  • Customer ID: ID pelanggan uji coba Anda
Meter Events
Anda akan melihat satu event untuk setiap pesan yang dikirim!
5

Verify token counting

Mari kirim beberapa pesan lagi dan periksa apakah agregasi token berfungsi:
  1. Di meter Anda, buka tab Customers
  2. Temukan pelanggan uji coba Anda
  3. Periksa kolom “Consumed Units”—kolom ini seharusnya menampilkan total token yang digunakan
Meter Customer Tokens
Meter secara otomatis menjumlahkan semua nilai totalTokens!
6

Test the free tier

Mari gunakan token yang cukup untuk melampaui tingkat gratis:
  1. Lakukan beberapa percakapan lagi (targetkan total sekitar 15.000+ token)
  2. Periksa kembali tab Customers di dashboard meter
  3. Anda sekarang akan melihat:
    • Consumed Units: 15.000+ token
    • Chargeable Units: 5.000 (10.000 token gratis telah diterapkan)
    • Total Price: sekitar $0.05
Free Tier Test
Berhasil! Penagihan berbasis penggunaan Anda berfungsi dengan sempurna. Pelanggan akan otomatis ditagih berdasarkan konsumsi token aktual mereka.

Pemecahan Masalah

Masalah umum dan solusinya:
Kemungkinan penyebab:
  • Nama event tidak sama persis dengan konfigurasi meter
  • Customer ID tidak ada di akun Anda
  • API key tidak valid atau sudah kedaluwarsa
  • Masalah konektivitas jaringan
Solusi:
  1. Pastikan nama event sama persis dengan konfigurasi meter (peka huruf besar-kecil: ai_chat_usage)
  2. Pastikan customer ID ada di dashboard Dodo Payments
  3. Uji API key dengan panggilan API sederhana
  4. Periksa server logs untuk pesan error
Kemungkinan penyebab:
  • Model tidak mengembalikan informasi penggunaan
  • Versi SDK tidak sesuai
Solusi:
  1. Uji apakah model mengembalikan penggunaan:
  1. Perbarui ke Blueprints SDK terbaru: npm install @dodopayments/ingestion-blueprints@latest
Kemungkinan penyebab:
  • API key salah untuk environment
  • Spasi atau tanda kutip tambahan dalam file .env
Solusi:
  • Pastikan test key diawali test_ dan live key diawali live_
  • Hapus tanda kutip di sekitar key dalam file .env
  • Buat key baru jika diperlukan
Butuh bantuan?

Selamat! Anda Telah Membangun Aplikasi Chat AI

Kini Anda memiliki aplikasi chat AI yang berfungsi penuh dengan pelacakan penggunaan token dan penagihan otomatis yang didukung oleh Dodo Payments. 🎉

Pelajari Lebih Lanjut

LLM Blueprint

Pelajari lebih lanjut tentang LLM Ingestion Blueprint

Ingestion Blueprints SDK

Lihat repository GitHub untuk contoh lainnya

Join Community

Dapatkan bantuan dan bagikan project Anda di Discord
Terakhir diubah pada 21 Juli 2026