Learning / AI Tools & Agent
Vikey sebagai Alternatif Provider API (Kalau Tidak Bisa Pakai OpenRouter)
Materi ini edukasi, bukan iklan atau ajakan afiliasi. Penulis tidak membuat akun, tidak top up, dan tidak memakai API key. Langkah di dalam dashboard (setelah login) tidak bisa diverifikasi langsung dan hanya dirangkum dari dokumentasi Vikey.
Diagram buatan sendiri.
Apa itu Vikey?
Menurut dokumentasinya sendiri, Vikey adalah proxy/gateway inference AI pihak ketiga dari Indonesia dengan sistem prabayar dalam Rupiah. Kamu memanggil banyak model lewat satu API yang kompatibel dengan format OpenAI. Syarat & Ketentuan Vikey menyebut endpoint-nya juga kompatibel dengan format Anthropic, dan bahwa Vikey tidak melatih atau mengoperasikan modelnya sendiri: request diteruskan ke "provider yang bekerja sama dengan kami".
Yang perlu dipahami:
- Vikey bukan OpenAI, Anthropic, atau OpenRouter. Di halaman yang dicek, kami tidak menemukan pernyataan bahwa Vikey adalah reseller atau mitra resmi OpenAI/Anthropic. Jangan berasumsi begitu.
- Saldo, API key, dan tagihanmu ada di akun Vikey. Saldo itu tidak masuk ke akun OpenAI/Anthropic, dan sebaliknya.
- Vikey mengiklankan harga "jauh di bawah harga resmi". Kami tidak bisa memverifikasi dari mana Vikey mendapat model tersebut atau bagaimana ketentuan provider aslinya berlaku. Untuk pekerjaan penting atau data sensitif, pertimbangkan provider resmi.
- Ketersediaan model bisa berubah: S&K menyebut daftar model bukan jaminan.
Kapan masuk akal dipakai?
- Kamu tidak punya kartu kredit/debit internasional. Vikey menyebut QRIS adalah satu-satunya metode pembayaran saat ini.
- Untuk belajar atau eksperimen dengan budget kecil (top up minimal Rp10.000 menurut docs).
- Kamu ingin satu key untuk mencoba beberapa model di Hermes, OpenCode, Claude Code, atau Codex.
Bukan untuk: mengakali pembatasan wilayah dari provider resmi, membagikan key, atau menjual ulang akses (dilarang di S&K Vikey).
Fakta penting
| Hal | Isi dari sumber resmi Vikey |
|---|---|
| Model bisnis | Prabayar, bayar per token, tanpa langganan (halaman Harga & S&K) |
| Pembayaran | QRIS lewat payment gateway; minimal Rp10.000, maksimal saat ini Rp50.000.000 per top up |
| Refund | Saldo top up tidak dapat dikembalikan, kecuali diwajibkan hukum atau ada kesalahan tagihan dari Vikey |
| Usia | Minimal 18 tahun |
| Base URL | https://api.vikey.ai/v1 |
| Autentikasi | Header Authorization: Bearer YOUR_API_KEY |
| Endpoint | POST /v1/chat/completions, POST /v1/completions, POST /v1/embeddings, GET /v1/models, GET /v1/models/:id; saldo: GET /v1/balance |
| API key | Bisa banyak, diberi nama, batas pemakaian opsional per key, bisa dinonaktifkan sementara |
| Saldo kurang | Request ditolak (bukan ditagih sebagian) |
| Log | Log detail per request disimpan 7 hari; isi prompt/respons tidak disimpan (menurut Kebijakan Privasi) |
| Harga | Per 1 juta token input/output dalam Rupiah di vikey.ai/pricing (berubah sewaktu-waktu, cek langsung, tidak kami salin di sini) |
Langkah: buat akun (dari docs.vikey.ai)
- Buka vikey.ai/register.
- Daftar dengan email + password, atau Google.
- Kolom kode undangan bersifat opsional. Kosongkan saja kalau tidak punya. (Vikey punya program afiliasi. Materi ini tidak memakai link referral.)
- Jika daftar via email: masukkan kode 6 digit yang dikirim ke email (berlaku 10 menit).
Langkah: top up via QRIS (dari docs)
- Masuk ke dashboard, lalu buka menu top up.
- Masukkan nominal (minimal Rp10.000). Mulailah dengan nominal kecil, karena saldo tidak bisa di-refund.
- Pindai QRIS dengan e-wallet atau mobile banking. Docs menyebut konfirmasi otomatis dalam hitungan detik.
- Top up yang belum dibayar bisa dibatalkan dari halaman detailnya.
Nama tombol dan tata letak dashboard tidak bisa kami verifikasi tanpa login, jadi ikuti label di layar.
Langkah: buat API key dengan batas
- Di dashboard, buat API key baru dan beri nama jelas, misalnya
hermes-laptop. - Isi batas pemakaian (fitur opsional per key menurut docs).
- Simpan key di password manager. Jangan tempel di chat, screenshot, atau file frontend.
Uji koneksi tanpa biaya
GET /v1/models hanya meminta daftar model, bukan inference. Docs tidak menyebut tarifnya, tapi endpoint ini tidak memakai token model. Jalankan di terminal, bukan di website:
export VIKEY_API_KEY="TEMPEL_KEY_DI_SINI_JANGAN_DI_COMMIT"
curl https://api.vikey.ai/v1/models -H "Authorization: Bearer $VIKEY_API_KEY"
curl https://api.vikey.ai/v1/balance -H "Authorization: Bearer $VIKEY_API_KEY"
Request chat (contoh dari docs) memotong saldo, jadi jalankan hanya kalau memang siap. Ganti MODEL_ID dengan id dari /v1/models:
curl https://api.vikey.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $VIKEY_API_KEY" \
-d '{"model": "MODEL_ID", "messages": [{"role": "user", "content": "Halo!"}]}'
Pakai di Hermes
Cara resmi Hermes (dari dokumentasi Hermes, berlaku untuk endpoint apa pun yang kompatibel OpenAI):
hermes model
# pilih "Custom endpoint", lalu isi:
# API base URL : https://api.vikey.ai/v1
# API key : (key Vikey kamu)
# Model name : (MODEL_ID dari /v1/models)
Vikey juga menampilkan snippet Hermes di jendela "Quick Start" pada halaman harganya:

Tangkapan layar halaman publik vikey.ai/pricing (jendela Quick Start, tab Hermes). Nama model di dalam gambar hanyalah contoh dari halaman itu. Hak cipta milik Vikey.
Format providers.<nama> dengan key_env memang didukung dokumentasi Hermes (named custom providers). Kami belum mengujinya dengan key sungguhan. Kalau gagal, pakai cara hermes model di atas.
Pakai di tool lain (snippet dari docs.vikey.ai)
- Codex CLI:
OPENAI_BASE_URL=https://api.vikey.ai/v1,OPENAI_API_KEY=…, lalucodex -m MODEL_ID - Claude Code:
ANTHROPIC_BASE_URL=https://api.vikey.ai,ANTHROPIC_API_KEY=…, laluclaude --model MODEL_ID - OpenAI SDK:
base_url="https://api.vikey.ai/v1"
Catatan: memakai gateway pihak ketiga di Claude Code/Codex artinya kamu tidak memakai akun resmi Anthropic/OpenAI. Fitur yang bergantung pada akun resmi mungkin tidak tersedia, dan kompatibilitas penuh tidak dijamin.
Privasi & data
Menurut Kebijakan Privasi Vikey:
- Isi request tidak disimpan di database atau log. Ada cache memori sementara (sekitar 10 menit).
- Request diteruskan ke provider model pihak ketiga yang memproses data sesuai kebijakan mereka sendiri, dan Vikey tidak mengendalikannya.
- Vikey sendiri menyarankan tidak mengirim data pribadi sensitif.
Jadi: jangan kirim password, data pelanggan, atau dokumen rahasia lewat gateway yang belum kamu audit.
Budget & keamanan
- Top up kecil, pasang batas per key, satu key per tool.
- Pantau
GET /v1/balancedan riwayat pemakaian di dashboard. - Key bocor? Nonaktifkan/hapus key di dashboard dulu, lalu buat key baru.
- Lihat juga materi Kontrol Biaya & Keamanan API.
Troubleshooting
| Masalah | Kemungkinan & solusi |
|---|---|
| 401 / unauthorized | Key salah atau nonaktif; cek header Bearer |
| Error saldo | Saldo kurang dari estimasi biaya; top up atau naikkan batas key |
| Model tidak ditemukan | Pakai id persis dari GET /v1/models |
| Hermes masih ke OpenRouter | Jalankan hermes model lagi, pilih Custom endpoint; cek hermes config show |
| QRIS sudah dibayar tapi saldo belum masuk | Hubungi support resmi di halaman Vikey (support@vikey.ai) dengan bukti bayar; jangan bayar dua kali |
Bandingkan dengan pilihan lain
| Provider resmi (OpenAI/Anthropic) | OpenRouter | Vikey | |
|---|---|---|---|
| Bayar | Kartu/metode yang didukung | Credits (lihat docs OpenRouter) | QRIS Rupiah |
| Hubungan ke model | Langsung | Router ke banyak provider | Gateway pihak ketiga |
| Limit | Spend limit organisasi/proyek | Limit per key | Batas per key (opsional) |
Latihan (tanpa biaya)
- Buka vikey.ai/pricing, pilih satu model, lalu hitung biaya 100.000 token input + 20.000 token output. Hitung sendiri dari angka di halaman.
- Baca bagian 3–5 Kebijakan Privasi. Tulis 2 jenis data yang tidak akan kamu kirim.
- Tulis konfigurasi Hermes di kertas memakai placeholder, tanpa key asli.
Glosarium
- Gateway/proxy: perantara yang meneruskan request ke provider model.
- Prabayar: isi saldo dulu, dipotong per pemakaian.
- Base URL: alamat dasar API.
- MODEL_ID: nama model persis yang dipakai API.
Video tutorial
Video milik kreatornya masing-masing, disematkan dari YouTube (tidak diunggah ulang). Jika isi video berbeda dengan materi, ikuti materi & dokumen resmi.
Channel: KUNE · Bahasa: Indonesia · Video terkait (pola custom endpoint)
⚠️ Memakai gateway 9Router, BUKAN Vikey. Berguna untuk melihat cara Hermes diarahkan ke endpoint custom; nilai base URL & key tetap pakai milik Vikey.
Tonton di YouTube ↗