Memulai Cepat

Dari daftar akun sampai request pertama ke gateway Hostlinku dalam lima menit

Halaman ini memandu Anda dari nol sampai berhasil mengirim satu request chat completion melalui Hostlinku.

Prasyarat

Akun Hostlinku — daftar gratis di auth.hostlinku.com.
Saldo kredit — gateway Hostlinku memotong saldo per token. Isi saldo di console sebelum request produksi (biaya request uji coba umumnya kurang dari satu sen, tetapi saldo tidak boleh kosong). Lihat Billing & Saldo.
Perkakas uji — curl sudah cukup. Untuk contoh lanjutan, SDK resmi OpenAI (pip install openai) atau Node (npm install openai) bisa dipakai tanpa perubahan kode.

Langkah-langkah

Daftar atau masuk

Buka auth.hostlinku.com dan buat akun baru — atau masuk dengan akun yang sudah ada (termasuk opsi login SSO yang diaktifkan oleh admin).

Buat kunci API

Masuk ke console.hostlinku.com → menu Kunci API → Buat Kunci. Di dialog pembuatan kunci Anda bisa mengatur:

Nama kunci — untuk identifikasi (mis. produksi-aplikasi-anda).
Kedaluwarsa — opsional: tidak pernah, 30/90/365 hari, atau tanggal kustom.
Limit kredit — opsional: batas pemakaian kunci (mis. $10) per jendela Harian / Mingguan / Bulanan, atau tanpa reset (limit total).

Secret hanya tampil sekali

Setelah kunci dibuat, secret berformat sk-… hanya ditampilkan satu kali di console. Salin dan simpan di tempat aman — server akan menyimpannya sebagai hash SHA-256 dan tidak bisa menampilkannya lagi. Jika secret hilang, revoke kunci lalu buat yang baru.

Kirim request pertama

Semua endpoint gateway berada di https://api.hostlinku.com, dengan autentikasi Authorization: Bearer sk-…. Contoh request non-streaming:

curl https://api.hostlinku.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-isi-kunci-anda" \
  -d '{
    "model": "gpt-5-4-mini",
    "messages": [
      { "role": "user", "content": "Halo! Perkenalkan diri Anda singkat saja." }
    ]
  }'

Jika semuanya benar, Anda akan menerima respons JSON bergaya OpenAI, ditambah blok hostlinku berisi biaya dan latensi request:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "gpt-5-4-mini",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Halo! Saya adalah …" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 18, "completion_tokens": 42, "total_tokens": 60 },
  "hostlinku": {
    "cost": 0.000123,
    "latencyMs": 812,
    "gateway": "…",
    "upstreamRequestId": "…",
    "usageSource": "upstream"
  }
}

Slug model di atas hanyalah contoh. Daftar slug yang valid untuk akun Anda bisa dilihat di console (menu Model) atau lewat endpoint GET /v1/models.

Cek saldo dan riwayat

Di console, buka menu Credits/Saldo untuk melihat saldo berjalan, dan menu Log Permintaan untuk riwayat request lengkap dengan token, biaya, dan latensi. Endpoint setara tersedia di GET /api/wallet/account untuk sesi console — API publik (kunci sk-…) memakai /v1/*.

Langkah berikutnya

Autentikasi — detail kunci API, kedaluwarsa, dan limit kredit.
Chat Completions — semua parameter, streaming SSE, dan contoh Python.
Model — katalog model dan cara memilih model yang tepat.
Error — arti setiap kode error dan cara menanganinya.

Catatan

Butuh bantuan? Hubungi [email protected] — lihat juga Dukungan.