OpenCode dengan UberLLM: penyedia yang lebih murah di opencode.json

Langkah-langkah

1. Buat sebuah key di halaman keys Anda dan tambahkan kredit.
2. Buka (atau buat) ~/.config/opencode/opencode.json. Untuk satu proyek saja, gunakan opencode.json di folder proyek sebagai gantinya.
3. Tambahkan provider:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "uberllm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "UberLLM",
      "options": {
        "baseURL": "https://api.uberllm.dev/v1",
        "apiKey": "{env:UBERLLM_API_KEY}"
      },
      "models": {
        "moonshotai/kimi-k3": { "name": "moonshotai/kimi-k3" },
        "deepseek/deepseek-v4.1-flash": { "name": "deepseek/deepseek-v4.1-flash" },
        "deepseek/deepseek-v4.1-flash": { "name": "deepseek/deepseek-v4.1-flash" }
      }
    }
  },
  "model": "uberllm/moonshotai/kimi-k3",
  "small_model": "uberllm/deepseek/deepseek-v4.1-flash"
}

4. Berikan key kepada OpenCode. Atur variabel yang dibaca config:

export UBERLLM_API_KEY=ull_your_key

atau jalankan /connect di dalam OpenCode, gulir ke Other, masukkan uberllm sebagai provider id dan tempelkan key-nya. id harus sama persis dengan nama di provider. Jika Anda menggunakan /connect, Anda bisa menghapus baris apiKey.

5. Mulai opencode, ketik /models dan pilih salah satu model UberLLM.

---

Mengapa ID model memiliki dua garis miring

OpenCode menamai sebuah model <provider>/<model>, dan ID UberLLM sudah mengandung garis miring (deepseek/…). OpenCode memisahkan hanya pada garis miring pertama, jadi uberllm/moonshotai/kimi-k3 berarti provider uberllm, model moonshotai/kimi-k3. Kunci di bawah models haruslah ID UberLLM persis seperti yang ada di uberllm.dev/models.

Beri Tahu OpenCode Ukuran Konteks

OpenCode menggunakan ukuran konteks untuk mengetahui kapan harus memadatkan sesi yang panjang. Tambahkan limit ke setiap model, menggunakan angka-angka di halaman modelnya:

"moonshotai/kimi-k3": {
  "name": "moonshotai/kimi-k3",
  "limit": { "context": 1000000, "output": 64000 }
}

Angka-angka di atas adalah contoh; salin yang asli untuk model yang Anda pilih.

---

Gunakan paket yang tepat

Jaga "npm": "@ai-sdk/openai-compatible". Paket itu memanggil /v1/chat/completions, rute yang diuji pada setiap model UberLLM.

Pemecahan Masalah

• ProviderModelNotFoundError: model yang Anda pilih tidak ada dalam daftar models, atau kunci di sana berbeda dari ID di "model". Tambahkan dengan ID UberLLM yang tepat.
• 401 / no answer: {env:UBERLLM_API_KEY} menjadi kosong ketika variabel tidak diatur di shell yang memulai OpenCode. Ekspor itu, atau gunakan /connect.
• /connect key not used: ID penyedia yang Anda ketik di sana bukan uberllm. Jalankan opencode auth list untuk melihat apa yang tersimpan.
• 404: periksa baseURL berakhir dengan /v1, dan paket npm adalah yang kompatibel dengan openai.
• 402 insufficient credits: tambahkan kredit di halaman kredit.

---

Lanjutkan membaca

• Halaman referensi: Dokumen OpenCode
• Pengaturan Kilo Code (format konfigurasi yang sama)
• Claude Code di UberLLM
• API Claude Termurah