Sapujagat.ai

Panduan integrasi Sapujagat

Dari API key ke balasan pertama. Panduan ini gratis dan bisa dibuka kembali kapan saja. Belum punya key? Daftar akun.

API key dipakai di mana?

Hubungkan ke aplikasi yang mendukung OpenAI-compatible. Pilih aplikasi di bawah, lalu isi tiga pengaturan ini.

Base URL
https://api.sapujagat.web.id/v1
API key
Gunakan key pribadi yang sudah Anda simpan. Tempel key saja, tanpa awalan Bearer, pada kolom API Key aplikasi.

Mulai dengan sapujagat-fast untuk biaya lebih hemat. Fast dan Pro adalah combo layanan; model upstream dapat berganti saat fallback. Cek harga dan model aktif di katalog API.

Akses belum aktif? Tunggu trial disetujui admin atau isi saldo prepaid. Anda tetap bisa menyiapkan aplikasi sekarang. Status dan batas pemakaian terlihat di Akun.

Hubungkan Cline di VS Code

  1. Pasang extension Cline di VS Code, lalu buka panel Cline dan Settings (ikon roda gigi).
  2. Pada API Provider, pilih OpenAI Compatible. Isi Base URL, API Key, dan Model ID sesuai pengaturan di atas.
  3. Buka Model Configuration. Untuk uji awal, atur Max Output Tokens ke 1024. Jika Plan dan Act memakai konfigurasi terpisah, isi keduanya.
  4. Simpan pengaturan. Mulai percakapan baru dan kirim: Balas singkat: Halo Sapujagat!
Panduan resmi Cline ↗

Berhasil kalau apa?

Anda menerima balasan AI, lalu request dan pemakaian token muncul di riwayat Akun. Setelah promo disetujui, sapujagat-fast memakai kuota gratis 10 juta token input + output tanpa memotong saldo. Pro dan request berbayar mengikuti tarif combo. Aplikasi agent bisa mengirim banyak request untuk satu tugas; mulai dari pesan pendek dan pantau pemakaian.

Jika promo Fast tidak cukup, request ditolak tanpa debit saldo. Kurangi konteks/output atau pilih saldo berbayar secara sengaja dengan header X-Sapujagat-Funding: paid. Promo tetap memiliki batas harian dan output 2.048 token/request, termasuk setelah top-up.

Jika belum berhasil, cek pesan error ini
  • 401 — Key tidak valid: cek key lengkap, tanpa spasi tambahan; buat key baru di Akun jika key lama dicabut.
  • 403 — Trial belum aktif: cek status di Akun dan sampaikan ID akun kepada admin.
  • 402 — Saldo/kuota habis: cek Akun, lalu gunakan voucher atau top-up admin.
  • 400/404 — Pengaturan tidak cocok: cek Base URL berakhir /v1, Model ID persis sesuai katalog, dan Max Output Tokens 1024. Gunakan Chat Completions; hanya max_tokens didukung sebagai kontrol output.
  • 429 — Batas pemakaian: kurangi request paralel; jika batas harian tercapai, tunggu reset atau hubungi admin.
  • 5xx/koneksi gagal: coba kembali setelah jeda. Jika berulang, kirim kode error dan ID akun kepada admin, tanpa API key.