Cara menghubungkan OpenCode ke CheapTokens (opencode.json)

Untuk menghubungkan OpenCode ke CheapTokens, tambahkan penyedia kustom yang kompatibel dengan OpenAI: simpan kunci API Anda dengan /connect (ID penyedia cheaptokens), lalu jelaskan penyedia di opencode.json dengan URL dasar https://api.cheaptokens.dev/v1. Setelah itu model CheapTokens Anda muncul di /models.

Panduan ini mengikuti dokumentasi penyedia OpenCode (halaman diperbarui 20 Oktober 2026; diperiksa 22 Oktober 2026). Pendekatan yang sama berlaku untuk alat lain dalam seri ini: Cline, Aider dan Kilo Code.

Yang Anda butuhkan#

• OpenCode terpasang (lihat dokumentasinya untuk platform Anda).
• Kunci API CheapTokens. Buat satu di akun Anda dan isi saldonya; satu saldo mencakup semua model. Dasar-dasarnya ada di dokumentasi CheapTokens.
• Fakta API:
  • URL dasar: https://api.cheaptokens.dev/v1
  • kompatibilitas: OpenAI Chat Completions dan Anthropic Messages
  • ID model yang digunakan di bawah: deepseek-ai/DeepSeek-V4-Flash-0731 (konteks 380K, hingga 32.768 token keluaran). ID model tercantum di dokumentasi CheapTokens: nama berbeda antar penyedia, jadi salin ID dari sana.

Langkah 1. Simpan kunci dengan /connect#

1. Mulai OpenCode di proyek Anda dan jalankan /connect.
2. Gulir ke Other.
3. Masukkan ID penyedia yang unik: cheaptokens.
4. Tempel kunci API CheapTokens Anda.

Langkah ini hanya menyimpan kredensial. OpenCode masih belum mengetahui alamat atau model penyedia: itulah gunanya opencode.json.

Langkah 2. Jelaskan penyedia di opencode.json#

Buat atau edit opencode.json dan tambahkan penyedia. ID penyedia di provider harus cocok dengan yang Anda masukkan di /connect.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

Apa fungsi setiap bagian:

• npm — @ai-sdk/openai-compatible adalah paket untuk endpoint yang menggunakan /v1/chat/completions, yang merupakan yang diekspos CheapTokens. (OpenCode menggunakan @ai-sdk/openai untuk endpoint yang dibangun di atas /v1/responses.)
• name — label yang ditampilkan di antarmuka OpenCode.
• options.baseURL — alamat API CheapTokens.
• models — dikunci berdasarkan ID model; name di dalamnya adalah nama tampilan.
• limit.context / limit.output — opsional; keduanya memberi tahu OpenCode jendela konteks model dan panjang jawaban maksimum.

Simpan kunci di variabel lingkungan sebagai gantinya (opsional)#

Jika Anda lebih suka tidak menyimpan kunci di penyimpanan kredensial OpenCode, tambahkan apiKey ke options dengan sintaks {env:VARIABLE} yang direkomendasikan dokumentasi:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Lalu ekspor CHEAPTOKENS_API_KEY di shell Anda. Jangan commit kunci asli ke repositori. Jika Anda baru mengenal kunci, baca apa itu kunci API dan cara menyimpannya dengan aman.

Langkah 3. Periksa apakah berfungsi#

Jalankan /models dan pilih DeepSeek-V4-Flash di bawah penyedia CheapTokens. Lalu kirim prompt singkat, misalnya: "Ringkas apa yang dilakukan repositori ini dalam tiga kalimat." Jawaban normal berarti URL dasar, kunci dan ID model semuanya benar.

Model CheapTokens mana yang harus dipilih#

Tambahkan sebanyak yang Anda suka ke models — masing-masing adalah blok seperti di atas, dengan ID-nya sendiri.

Untuk sesi OpenCode, yang mengirim banyak permintaan dalam loop, DeepSeek-V4-Flash adalah default yang baik: keluaran lebih murah daripada harga referensi OpenRouter, jawaban dapat mencapai 32.768 token, dan harganya tidak memiliki jam sibuk. MiniMax-M2.7 juga lebih murah daripada harga referensi OpenRouter pada input dan output. Keluaran GLM-5.3-Flash juga lebih murah daripada harga referensi OpenRouter. Harga saat ini (diperiksa langsung, tidak ada angka yang basi):

Untuk memperkirakan sesi kerja, misalnya 20 permintaan dengan 100.000 input dan 5.000 token keluaran masing-masing:

Lihat semua harga dan halaman DeepSeek untuk selengkapnya.

Jika tidak berfungsi#

• Penyedia atau model hilang dari /models. Periksa bahwa opencode.json adalah JSON yang valid (tanpa koma di akhir) dan bahwa kunci di bawah provider persis ID yang Anda masukkan di /connect. Jika keduanya benar, mulai ulang OpenCode.
• 401 / kesalahan autentikasi. Jalankan ulang /connect dan tempel kunci lagi, atau periksa variabel CHEAPTOKENS_API_KEY di shell tempat OpenCode dimulai.
• 404 atau "model not found". ID model di models harus cocok dengan ID CheapTokens karakter demi karakter, termasuk prefiks vendor (deepseek-ai/…).
• Kesalahan koneksi. URL dasar harus diakhiri dengan /v1 dan tidak mengandung path tambahan. Lihat kesalahan koneksi umum.
• "Not enough tokens". Isi saldonya; lihat apa arti kesalahan itu.

Langkah selanjutnya#

Anda sekarang memiliki OpenCode yang berjalan di CheapTokens dengan satu saldo untuk semua model. Dapatkan kunci dan lakukan panggilan pertama Anda dari dokumentasi CheapTokens.