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 alur request lewat gateway

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

HalIsi dari sumber resmi Vikey
Model bisnisPrabayar, bayar per token, tanpa langganan (halaman Harga & S&K)
PembayaranQRIS lewat payment gateway; minimal Rp10.000, maksimal saat ini Rp50.000.000 per top up
RefundSaldo top up tidak dapat dikembalikan, kecuali diwajibkan hukum atau ada kesalahan tagihan dari Vikey
UsiaMinimal 18 tahun
Base URLhttps://api.vikey.ai/v1
AutentikasiHeader Authorization: Bearer YOUR_API_KEY
EndpointPOST /v1/chat/completions, POST /v1/completions, POST /v1/embeddings, GET /v1/models, GET /v1/models/:id; saldo: GET /v1/balance
API keyBisa banyak, diberi nama, batas pemakaian opsional per key, bisa dinonaktifkan sementara
Saldo kurangRequest ditolak (bukan ditagih sebagian)
LogLog detail per request disimpan 7 hari; isi prompt/respons tidak disimpan (menurut Kebijakan Privasi)
HargaPer 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)

  1. Buka vikey.ai/register.
  2. Daftar dengan email + password, atau Google.
  3. Kolom kode undangan bersifat opsional. Kosongkan saja kalau tidak punya. (Vikey punya program afiliasi. Materi ini tidak memakai link referral.)
  4. Jika daftar via email: masukkan kode 6 digit yang dikirim ke email (berlaku 10 menit).

Langkah: top up via QRIS (dari docs)

  1. Masuk ke dashboard, lalu buka menu top up.
  2. Masukkan nominal (minimal Rp10.000). Mulailah dengan nominal kecil, karena saldo tidak bisa di-refund.
  3. Pindai QRIS dengan e-wallet atau mobile banking. Docs menyebut konfirmasi otomatis dalam hitungan detik.
  4. 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

  1. Di dashboard, buat API key baru dan beri nama jelas, misalnya hermes-laptop.
  2. Isi batas pemakaian (fitur opsional per key menurut docs).
  3. 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 Quick Start Hermes di vikey.ai/pricing

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=…, lalu codex -m MODEL_ID
  • Claude Code: ANTHROPIC_BASE_URL=https://api.vikey.ai, ANTHROPIC_API_KEY=…, lalu claude --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/balance dan riwayat pemakaian di dashboard.
  • Key bocor? Nonaktifkan/hapus key di dashboard dulu, lalu buat key baru.
  • Lihat juga materi Kontrol Biaya & Keamanan API.

Troubleshooting

MasalahKemungkinan & solusi
401 / unauthorizedKey salah atau nonaktif; cek header Bearer
Error saldoSaldo kurang dari estimasi biaya; top up atau naikkan batas key
Model tidak ditemukanPakai id persis dari GET /v1/models
Hermes masih ke OpenRouterJalankan hermes model lagi, pilih Custom endpoint; cek hermes config show
QRIS sudah dibayar tapi saldo belum masukHubungi support resmi di halaman Vikey (support@vikey.ai) dengan bukti bayar; jangan bayar dua kali

Bandingkan dengan pilihan lain

Provider resmi (OpenAI/Anthropic)OpenRouterVikey
BayarKartu/metode yang didukungCredits (lihat docs OpenRouter)QRIS Rupiah
Hubungan ke modelLangsungRouter ke banyak providerGateway pihak ketiga
LimitSpend limit organisasi/proyekLimit per keyBatas per key (opsional)

Latihan (tanpa biaya)

  1. Buka vikey.ai/pricing, pilih satu model, lalu hitung biaya 100.000 token input + 20.000 token output. Hitung sendiri dari angka di halaman.
  2. Baca bagian 3–5 Kebijakan Privasi. Tulis 2 jenis data yang tidak akan kamu kirim.
  3. 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.

Video baru dimuat setelah diklik (youtube-nocookie.com).
Setup Hermes Agent + 9Router | AI Agent Lokal dari Nol
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 ↗
Gabung grup