Troubleshooting

Mulai dari tes paling sederhana. Kalau perintah ini berhasil, key dan saldo kamu beres, dan masalahnya ada di config tool:

curl https://api.vikey.ai/v1/chat/completions \
  -H "Authorization: Bearer API_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/gpt-6-luna", "max_tokens": 16, "messages": [{"role": "user", "content": "ping"}]}'

Masalah umum

Gejala	Penyebab paling mungkin	Solusi
404 di semua request	Base URL salah. SDK OpenAI butuh /v1, SDK Anthropic dan Claude Code tidak.	Lihat Base URL
401 Invalid API key	Key salah, ada spasi, atau key milik akun lain	Salin ulang dari menu API Keys
401 padahal key benar	Tool mengirim key di header yang salah, atau variabel environment belum terbaca	Cek panduan tool kamu di bagian Coding agent
402 Insufficient balance	Saldo habis atau max_tokens terlalu besar untuk saldo yang tersisa	Top up, atau kecilkan max_tokens
403 API key is inactive	Key dinonaktifkan	Aktifkan lagi di menu API Keys
Model '...' not found	Model id salah ketik, atau tool mengirim nama model bawaannya	Pakai id dari halaman harga. Untuk Claude Code, pasang modelOverrides.
ambiguous_model	Nama pendek cocok dengan beberapa provider	Pakai id lengkap seperti deepseek/deepseek-v4.1-flash
Codex: wire_api = "chat" is no longer supported	Config Codex lama	Ganti jadi wire_api = "responses", lihat Codex
opencode: Model not found: vikey/...	Format providers yang belum didukung, atau model belum ada di models	Pakai format di opencode
Claude Code: diminta login	Key ada di settings proyek, bukan di settings user atau shell	Lihat Claude Code
Biaya lebih besar dari perkiraan	Prompt panjang dikirim ulang tanpa cache, atau model mahal dipakai untuk tugas ringan	Cek menu Usage per model, pertimbangkan Vikey Auto
Jawaban terputus di tengah	Batas max_tokens tercapai	Naikkan max_tokens
502 atau 503	Model sedang bermasalah di sisi penyedia	Ulangi sebentar lagi, atau pakai model lain

Masih bermasalah?

Hubungi kami lewat Telegram atau WhatsApp. Sertakan:

• request_id dari pesan error, kalau ada
• Tool dan versinya, misalnya Claude Code 2.1.323
• Model id yang dipakai
• Waktu kejadian

Jangan kirim API key kamu ke siapa pun, termasuk ke support.