Cara Pakai Model AI Bansos di APIPedia (Gratis): Panduan 8 Langkah

Oleh , Tim Engineering APIPedia · Terbit · 4 menit baca

Tukar voucher Bansos, buat token, lalu panggil model Claude dengan awalan bansos/ lewat AI Gateway APIPedia. Gratis, lengkap dengan screenshot dan contoh kode.

Cara pakai model AI Bansos di APIPedia: katalog model provider Bansos di console

Bansos adalah program kredit AI gratis dari APIPedia. Setelah menukar voucher Bansos, kamu bisa memanggil model Claude (Haiku, Sonnet, Opus) lewat AI Gateway APIPedia tanpa mengisi saldo. Caranya cukup 8 langkah: punya akun console, tukar voucher, buat token, lalu panggil model dengan awalan bansos/.

Apa itu kredit AI Bansos?

Kredit Bansos adalah kredit AI hadiah yang masuk lewat voucher. Kredit ini gratis, terpisah dari saldo AI utama, dan khusus untuk model dari provider Bansos. Kredit Bansos berlaku paling lambat sampai 21 November 2026 pukul 23.59 WIB; tanggal pastinya tampil di pesan sukses saat voucher ditukar.

Yang perlu disiapkan

  • Akun di console.apipedia.id.
  • Kode voucher Bansos yang kamu dapatkan dari admin atau komunitas APIPedia.

Langkah 1: Pastikan sudah punya akun console

Buka console.apipedia.id/register, isi nama, email, dan kata sandi, lalu klik Daftar. Bisa juga lewat tombol Masuk dengan Google. Kalau sudah punya akun, langsung masuk saja.

Halaman daftar akun console APIPedia dengan tombol Daftar ditandai

Langkah 2 dan 3: Buka halaman voucher, lalu masukkan kode

Buka console.apipedia.id/vouchers. Ketik kode voucher yang kamu dapatkan di kolom Kode voucher (huruf besar-kecil tidak berpengaruh), lalu klik Tukarkan.

Halaman Tukar voucher: kolom kode voucher dan tombol Tukarkan ditandai

Langkah 4: Redeem berhasil

Kalau kode valid, muncul pesan Voucher ditukar beserta jumlah kredit dan tanggal berlakunya. Penukaran juga tercatat di tabel Riwayat penukaran.

Pesan Voucher ditukar: kredit Bansos masuk dan tanggal berlakunya

Angka dan tanggal di gambar hanya contoh. Nilai kredit mengikuti voucher yang kamu tukar.

Langkah 5: Buat token di menu Token

Buka console.apipedia.id/api/token, klik Buat token, beri nama (mis. "Laptop"), lalu salin token yang muncul. Token hanya ditampilkan sekali, jadi simpan di tempat aman dan jangan dibagikan.

Halaman Token API dengan tombol Buat token ditandai

Langkah 6 dan 7: Buka katalog AI, filter provider Bansos

Buka console.apipedia.id/apis?tab=models (menu Katalog, tab AI). Di kolom filter provider, pilih Bansos. Daftar langsung menyaring model yang bisa dipakai dengan kredit Bansos.

Katalog AI di console: tab AI dan filter provider Bansos ditandai

Langkah 8: Pakai model dari provider Bansos

Salin nama model lengkap dengan awalan bansos/, misalnya bansos/claude-haiku-4-5-20251001, lewat tombol salin di sebelahnya. Awalan inilah yang membuat permintaan memakai kredit Bansos; tanpa awalan itu, permintaan memakai provider default dan saldo AI utama.

Tabel model provider Bansos dengan nama model bansos/claude-haiku-4-5-20251001 ditandai

Contoh panggilan dengan cURL

Ganti TOKEN_ANDA dengan token dari langkah 5.

curl https://api.apipedia.id/v1/ai/messages \
  -H "Authorization: Bearer TOKEN_ANDA" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bansos/claude-haiku-4-5-20251001",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Tulis tiga ide judul artikel tentang UMKM digital."}]
  }'

Contoh dengan SDK Anthropic (Python)

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.apipedia.id/v1/ai",
    api_key="TOKEN_ANDA",
)

msg = client.messages.create(
    model="bansos/claude-haiku-4-5-20251001",
    max_tokens=512,
    messages=[{"role": "user", "content": "Halo! Jelaskan API gateway dalam satu paragraf."}],
)
print(msg.content[0].text)

Base URL https://api.apipedia.id/v1/ai juga bisa dipakai di aplikasi atau tool lain yang mendukung API Anthropic. Isi API key dengan token APIPedia dan nama model dengan awalan bansos/. Dokumentasi lengkap ada di apipedia.id/docs/ai-gateway.

Tips supaya kredit Bansos awet

  • Pakai Claude Haiku untuk tugas ringan; harganya jauh lebih murah per juta token dibanding Sonnet atau Opus. Harga per model tampil di katalog.
  • Batasi max_tokens sesuai kebutuhan jawaban.
  • Pantau pemakaian di menu Penggunaan dan sisa kredit di menu Saldo console.
  • Habiskan sebelum tenggatnya: kredit Bansos yang tidak terpakai hangus paling lambat 21 November 2026.

Pertanyaan umum

Apakah kredit Bansos benar-benar gratis?

Ya. Kredit Bansos diberikan lewat voucher tanpa biaya dan tanpa perlu mengisi saldo.

Kenapa permintaan saya memotong saldo AI utama, bukan kredit Bansos?

Pastikan nama model diawali bansos/, misalnya bansos/claude-haiku-4-5-20251001. Model tanpa awalan itu dilayani provider default.

Voucher saya ditolak, kenapa?

Kemungkinan kode salah ketik, kuota voucher sudah habis, sudah pernah kamu tukar, atau masa berlakunya sudah lewat. Pesan penolakan di halaman voucher menjelaskan alasannya.

Kredit Bansos habis, bagaimana selanjutnya?

Kamu tetap bisa memakai model gratis di katalog (dengan batas request harian) atau mengisi saldo AI di menu Saldo untuk model berbayar.

Ada kendala? Hubungi admin

Kalau voucher tidak bisa ditukar atau panggilan model gagal, hubungi admin lewat WhatsApp atau buat tiket di menu Bantuan console. Sertakan kode voucher dan pesan error yang muncul supaya cepat ditangani.

Topik:

Tentang penulis

Tim APIPedia — Tim Engineering APIPedia

Tim engineering di balik APIPedia yang membangun dan memelihara API data Indonesia - ongkir, OCR KTP, data wilayah, BMKG, hingga server MCP - dan menulis panduan integrasinya dari pengalaman langsung.