Hostlinku

Hostlinku Docs

Dokumentasi

Menu

OpenCode

Daftarkan Hostlinku sebagai provider kustom OpenAI-compatible di opencode.json dan pilih model lewat /models

OpenCode memakai AI SDK sehingga provider mana pun yang OpenAI-compatible bisa ditambahkan lewat opencode.json. Kredensial disimpan terpisah oleh perintah /connect.

Simpan kredensial

Di dalam OpenCode jalankan /connect, gulir ke Other, isi ID provider hostlinku, lalu tempel API key sk-…. Key disimpan di ~/.local/share/opencode/auth.json.

/connect  →  Other  →  provider id: hostlinku  →  API key: sk-…

Definisikan provider

Buat/ubah opencode.json di root proyek (atau ~/.config/opencode/opencode.json untuk global):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "hostlinku": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hostlinku",
      "options": {
        "baseURL": "https://api.hostlinku.com/v1"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "limit": { "context": 1000000, "output": 64000 }
        },
        "gpt-5-5": {
          "name": "GPT-5.5",
          "limit": { "context": 1000000, "output": 64000 }
        },
        "deepseek-v4-flash": {
          "name": "DeepSeek V4 Flash",
          "limit": { "context": 1000000, "output": 32000 }
        }
      }
    }
  },
  "model": "hostlinku/claude-sonnet-4-6",
  "small_model": "hostlinku/deepseek-v4-flash"
}

ID provider di opencode.json harus sama dengan yang dimasukkan saat /connect. Kunci di models adalah slug Hostlinku; limit membantu OpenCode menghitung sisa konteks.

Pilih model

Jalankan /models — grup Hostlinku muncul dengan model yang kamu daftarkan. small_model dipakai untuk tugas ringan (judul sesi, ringkasan) sehingga sesi panjang lebih hemat.

Variasi konfigurasi

API key dari environment variable (tanpa /connect):

{
  "provider": {
    "hostlinku": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hostlinku",
      "options": {
        "baseURL": "https://api.hostlinku.com/v1",
        "apiKey": "{env:HOSTLINKU_API_KEY}"
      }
    }
  }
}

Lewat Responses API — ganti npm menjadi @ai-sdk/openai; OpenCode akan memakai /v1/responses. Berguna untuk model GPT-5.x bila ingin reasoning summary. Untuk sebagian besar pengguna, @ai-sdk/openai-compatible (Chat Completions) sudah cukup.

Troubleshooting

  • Provider tidak muncul di /models — ID di /connect dan opencode.json berbeda, atau JSON tidak valid. Cek opencode auth list.
  • 401 — key belum tersimpan untuk ID tersebut; ulangi /connect.
  • 404 model_not_found — kunci models harus slug persis dari GET /v1/models.