Model

Endpoint GET /v1/models, bentuk data katalog, dan cara memilih model yang tepat

Hostlinku menyediakan satu katalog model terpusat. Setiap model punya slug unik yang dipakai di parameter model pada Chat Completions, lengkap dengan provider, ukuran konteks, kapabilitas, dan harga per token.

`GET /v1/models`

Mengembalikan semua model yang berstatus available dan belum deprecated pada akun Anda.

GET https://api.hostlinku.com/v1/models
Authorization: Bearer sk-isi-kunci-anda

Contoh:

curl https://api.hostlinku.com/v1/models \
  -H "Authorization: Bearer sk-isi-kunci-anda"

Respons (contoh dipotong; nilai persis untuk akun Anda diambil dari endpoint ini):

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5-4-mini",
      "object": "model",
      "created": 1759296000,
      "owned_by": "openai",
      "context_window": 128000,
      "capabilities": ["text", "tool-calling", "json-mode", "streaming"],
      "pricing": {
        "input": 0.00000015,
        "output": 0.0000006,
        "currency": "USD"
      }
    }
  ]
}

Field	Arti
`id`	Slug model — nilai yang dipakai di request `POST /v1/chat/completions`.
`created`	Waktu model ditambahkan ke katalog (Unix epoch, detik).
`owned_by`	Slug provider upstream (mis. `openai`, `anthropic`, `google`, `deepseek`).
`context_window`	Ukuran konteks maksimum dalam token (input + output).
`capabilities`	Daftar kapabilitas, mis. `vision`, `tool-calling`, `json-mode`, `reasoning`.
`pricing.input` / `pricing.output`	Harga per 1 token dalam USD (bukan per 1K). Nilai `null` bila model belum punya harga.

Pricing di respons adalah harga customer

Angka pricing adalah harga yang Anda bayar; margin platform sudah termasuk di dalamnya. Biaya aktual setiap request selalu muncul di blok hostlinku.cost pada respons dan di log console.

Katalog publik (tanpa autentikasi)

Untuk situs marketing atau eksplorasi tanpa kunci, tersedia katalog publik:

GET https://api.hostlinku.com/api/public/models

Query yang didukung: q (pencarian nama/deskripsi), provider, capability, family, sort (popular, newest, price-asc, price-desc, context-desc, name-asc), page, dan pageSize (maks 100). Respons memuat items, total, page, pageSize, dan totalPages.

Cara memilih model

Tentukan kebutuhan — chat biasa, penalaran (reasoning), vision/multimodal, tool calling, atau output JSON terstruktur. Cek field capabilities.
Perhatikan ukuran konteks — pastikan context_window cukup untuk prompt + output Anda.
Bandingkan harga — pricing.input untuk token prompt dan pricing.output untuk token jawaban; model reasoning umumnya lebih mahal di output.
Mulai dari model kecil — untuk pengembangan, model mini/flash (mis. gpt-5-4-mini, deepseek-v4-1-flash, gemini-3-5-flash) jauh lebih murah; naikkan kelas model hanya bila kualitas kurang.
Lihat konsol — menu Model di console.hostlinku.com menampilkan katalog dengan harga dan kapabilitas yang sama, plus halaman detail per model.

Alias slug

Gunakan slug persis seperti yang dikembalikan GET /v1/models — slug tidak case-sensitive di sisi tampilan, tetapi selalu salin apa adanya dari katalog untuk menghindari salah ketik. Model yang sudah deprecated mengembalikan 503 MODEL_UNAVAILABLE beserta saran slug penggantinya bila tersedia.

Routing dan failover

Model di katalog dipetakan ke satu atau beberapa gateway/provider (diatur di backend). Jika gateway utama gagal (5xx/timeout), request otomatis dicoba ke gateway berikutnya sebelum menyerah — Anda tetap memakai slug model yang sama dan tidak perlu mengubah apa pun. ID gateway yang akhirnya melayani request terlihat di field hostlinku.gateway pada respons.

Model

`GET /v1/models`

Katalog publik (tanpa autentikasi)

Cara memilih model

Routing dan failover

PRODUK

DOKUMENTASI

BANTUAN