> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Error yang sering muncul

> Penyebab dan solusi kode error Hostlinku yang paling sering ditemui.

Semua error memakai envelope yang sama: `{"error": {"code": "...", "message": "..."}}`. Daftar lengkap ada di [Error](https://docs.hostlinku.com/errors.md).

## 401 UNAUTHORIZED

API key tidak ada, salah salin, sudah dicabut, atau kedaluwarsa. Pastikan header memakai `Authorization: Bearer sk-...` atau `x-api-key`, lalu cek status key di Console → **API Keys**.

## 402 PAYMENT\_REQUIRED

Ada dua penyebab:

* **Saldo akun** tidak cukup untuk estimasi biaya request.
* **Limit kredit API key** tercapai (harian, mingguan, bulanan, atau total).

Baca pesan error untuk membedakannya. Cek saldo dan limit key di Console. Detail: [Billing & Saldo](https://docs.hostlinku.com/billing.md).

## 404 MODEL\_NOT\_FOUND

Slug model tidak ada di katalog. Ambil slug persis dari `GET /v1/models` atau halaman [Model](https://docs.hostlinku.com/models.md). Jangan menebak slug dari nama tampilan.

## 400 MODEL\_NOT\_IN\_SERVICE\_MODE

Model ada, tetapi tidak tersedia untuk Service Mode API key yang dipakai. Contoh: key Low-Cost memanggil model yang hanya punya rute Performance. Buat key dengan mode yang sesuai atau pilih model lain.

## 422 VALIDATION\_FAILED

Body request tidak lolos validasi: `messages` kosong, tipe field salah, atau field wajib hilang. Respons menyertakan detail per field. Periksa contoh body di [Chat Completions](https://docs.hostlinku.com/chat-completions.md).

## 429 RATE\_LIMITED

Batas request terlampaui. Baca header `Retry-After` dan `RateLimit-*`, lalu ulangi dengan backoff eksponensial. Request yang ditolak limiter tidak memotong saldo. Detail: [Pemakaian & Limit](https://docs.hostlinku.com/usage-and-limits.md).

## 503 MODEL\_UNAVAILABLE / UPSTREAM\_ERROR

Model sedang deprecated/tidak tersedia, atau upstream mengalami gangguan sementara. Untuk `UPSTREAM_ERROR`, coba lagi beberapa saat. Untuk `MODEL_UNAVAILABLE`, cek pesan error apakah ada `replacement_slug`.

Tips debugging

Simpan `x-request-id` dari header respons. ID itu bisa dipakai untuk mencocokkan request dengan log di Console saat menghubungi dukungan.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.