FAQ

Pertanyaan yang paling sering muncul tentang gateway Hostlinku

Apakah SDK resmi OpenAI bisa dipakai?

Bisa, tanpa perubahan kode. Cukup arahkan base_url/baseURL ke https://api.hostlinku.com/v1 dan pakai kunci sk-… Hostlinku sebagai api_key. Contoh lengkap ada di Chat Completions.

Endpoint apa saja yang tersedia?

Saat ini gateway mengutamakan dua endpoint inti yang kompatibel OpenAI:

• POST /v1/chat/completions — Chat Completions
• GET /v1/models — Model

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 kunci API.

Model apa saja yang bisa saya pakai?

Lihat Model — 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/bukan format Bearer, kunci salah salin, kunci sudah di-revoke, atau kunci sudah lewat masa berlaku. Buat/periksa kunci di console.hostlinku.com. Detail: Autentikasi.

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 kunci tercapai. Kalau pesannya menyebut "Limit kredit kunci", tunggu jendela reset (harian/mingguan/bulanan) atau ubah limit di console. Selengkapnya di Billing & Saldo.

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.

Apakah ada rate limit?

Ya — 600 request/menit per kunci API untuk chat completions, plus batas per IP untuk endpoint konsol. Angka dan strategi backoff-nya ada di Pemakaian & Limit.

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. Dukungan penuh tergantung provider model.

Bagaimana cara menghentikan pemakaian kunci yang bocor?

Segera revoke kunci tersebut di console → Kunci API. Kunci 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, provider, status, jumlah token, biaya, latensi, dan ID request — yang dibutuhkan untuk penagihan dan pemantauan. Untuk pertanyaan spesifik soal retensi data sesuai kebutuhan kepatuhan Anda, hubungi [email protected].

Bagaimana cara menghubungi dukungan?

Lihat Dukungan — email [email protected], sebaiknya sertakan x-request-id dari respons bermasalah.