# Troubleshooting

> Masalah yang paling sering muncul saat memakai Vikey dan cara memperbaikinya.

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

```bash
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](/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](/account/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](https://vikey.ai/pricing). Untuk Claude Code, pasang [`modelOverrides`](/agents/claude-code/). |
| `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](/agents/codex/) |
| opencode: `Model not found: vikey/...` | Format `providers` yang belum didukung, atau model belum ada di `models` | Pakai format di [opencode](/agents/opencode/) |
| Claude Code: diminta login | Key ada di settings proyek, bukan di settings user atau shell | Lihat [Claude Code](/agents/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](/models/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](https://t.me/+gAhmT7YKbtRmZWM9) atau [WhatsApp](https://wa.me/6287780232611). 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.

Source: https://docs.vikey.ai/troubleshooting/