> ## 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.

# FAQ

> Pertanyaan yang paling sering muncul tentang gateway Hostlinku

## Topik

* [Stream Mode](https://docs.hostlinku.com/faqs/stream-mode.md): cara memakai SSE dengan OpenAI SDK, Python `requests`, dan curl.
* [Error yang sering muncul](https://docs.hostlinku.com/faqs/errors.md): 401, 402, 404, 422, 429, dan 503.
* [Rate limit](https://docs.hostlinku.com/faqs/rate-limits.md): kuota, header `Retry-After`, dan backoff.
* [Billing & top-up](https://docs.hostlinku.com/faqs/billing.md): saldo, limit key, dan error 402.
* [Model tidak tersedia](https://docs.hostlinku.com/faqs/model-unavailable.md): 404 vs 503, deprecated, dan Service Mode.

## Apakah SDK resmi OpenAI bisa dipakai?

Bisa, tanpa perubahan kode. Arahkan `base_url`/`baseURL` ke `https://api.hostlinku.com/v1` dan
pakai API key `sk-…` Hostlinku sebagai `api_key`. Contoh lengkap ada di
[Chat Completions](https://docs.hostlinku.com/chat-completions.md#contoh-python-sdk-resmi-openai).

## Endpoint apa saja yang tersedia?

Saat ini gateway mengutamakan dua endpoint inti yang kompatibel OpenAI:

* `POST /v1/chat/completions`: [Chat Completions](https://docs.hostlinku.com/chat-completions.md)
* `GET /v1/models`: [Model](https://docs.hostlinku.com/models.md)

Endpoint lain (mis. embeddings) belum tersedia di gateway publik. Katalog publik non-`/v1`
(untuk situs) tersedia di `/api/public/models`. Halaman konsol memakai endpoint `/api/*` dengan
sesi cookie, bukan API key.

## Model apa saja yang bisa saya pakai?

Lihat [Model](https://docs.hostlinku.com/models.md): daftar resminya diambil dari `GET /v1/models` atau menu **Model**
di console. Katalog mencakup model dari OpenAI, Anthropic, Google, DeepSeek, Qwen, dan lainnya,
masing-masing dengan slug unik.

## Kenapa request saya ditolak 401?

Penyebab paling umum: header `Authorization` tidak ada atau bukan format `Bearer`, API key salah
salin, sudah di-revoke, atau sudah lewat masa berlaku. Buat/periksa API key di
[console.hostlinku.com](https://console.hostlinku.com). Detail lengkap:
[Autentikasi](https://docs.hostlinku.com/authentication.md).

## Kenapa muncul 402 padahal saya punya saldo?

Periksa pesan errornya. 402 punya dua sebab: **saldo akun** tidak cukup (`available` kurang dari
estimasi biaya request), atau **limit kredit API key** tercapai. Kalau pesannya menyebut "Limit
kredit API key", tunggu jendela reset (harian/mingguan/bulanan) atau ubah limitnya di console.
Selengkapnya di [Billing & Saldo](https://docs.hostlinku.com/billing.md).

## Berapa biaya satu request?

Biaya = token input × harga input + token output × harga output (per token, sesuai model). Harga
tiap model ada di katalog; biaya aktual setiap request muncul di `hostlinku.cost` dan di log
console. Rincian ada di [Billing & Saldo](https://docs.hostlinku.com/billing.md).

## Apakah ada rate limit?

Ya: 600 request/menit per API key untuk chat completions, plus batas per IP untuk endpoint
konsol. Angka lengkap dan strategi backoff ada di [Pemakaian & Limit](https://docs.hostlinku.com/usage-and-limits.md).

## Bagaimana cara mengirim pesan gambar / multimodal?

Isi `messages[].content` dengan array konten format OpenAI (mis. satu objek bertipe `image_url`
lalu satu objek bertipe `text`) dan pilih model yang punya kapabilitas `vision`/`image-input` di
katalog. Tingkat dukungan tergantung provider model.

## Bagaimana cara menghentikan pemakaian API key yang bocor?

Segera **revoke** API key tersebut di console, menu **API Keys**. API key yang di-revoke langsung
ditolak (401) untuk seluruh request berikutnya. Untuk menghapus permanen, gunakan **purge**.
Riwayat pemakaian sebelum revoke tetap tercatat untuk audit.

## Apakah log request menyimpan isi percakapan saya?

Log request menyimpan **metadata teknis**: model, status, jumlah token, biaya, latensi, dan ID
request. Data itu dibutuhkan untuk penagihan dan pemantauan. Untuk pertanyaan soal retensi
data sesuai kebutuhan kepatuhan kamu, hubungi
[halo@hostlinku.com](mailto:halo@hostlinku.com).

## Bagaimana cara menghubungi dukungan?

Lihat [Dukungan](https://docs.hostlinku.com/support.md): email **[halo@hostlinku.com](mailto:halo@hostlinku.com)**, sebaiknya sertakan
`x-request-id` dari respons bermasalah.

Tidak menemukan jawaban?

Kirim pertanyaan ke [halo@hostlinku.com](mailto:halo@hostlinku.com). FAQ ini diperbarui
berdasarkan pertanyaan yang paling sering masuk.


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