Beranda → Panduan → OpenCode dengan API kustom: konfigurasi, Claude, small_model, dan biaya nyata

OpenCode dengan API kustom: konfigurasi, Claude, small_model, dan biaya nyata

OpenCode membaca penyedianya dari opencode.json, jadi penyiapannya cukup satu berkas. Yang mengejutkan adalah tagihannya: meminta satu kata saja menghasilkan dua permintaan dan lebih dari 12.000 token masukan. Kami menjalankan OpenCode 1.19.0 di gateway kami dengan tiga model untuk menunjukkan ke mana token terpakai dan cara memangkasnya.

Berkas konfigurasi

Taruh ini di ~/.config/opencode/opencode.json (atau opencode.json di proyek Anda):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiclan": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APICLAN",
      "options": {
        "baseURL": "https://apiclan.us/v1",
        "apiKey": "{env:APICLAN_GPT_KEY}"
      },
      "models": {
        "gpt-6-astra": {},
        "gpt-6.1-sol": {}
      }
    }
  }
}

1. Buat kunci di konsol dan setel sebagai variabel lingkungan, misalnya APICLAN_GPT_KEY.
2. Di models, cantumkan hanya model dari grup kunci tersebut. Setiap kunci hanya milik satu grup, jadi GPT, DeepSeek, dan Claude masing-masing perlu entri penyedia dan kunci sendiri.
3. Jalankan opencode, ketik /models, lalu pilih APICLAN → gpt-6-astra. Untuk skrip: opencode run -m apiclan/gpt-6-astra "...".

baseURL	Hasil
https://apiclan.us/v1	✓
https://apiclan.us	✗ 404 Not Found

@ai-sdk/openai-compatible hanya menambahkan /chat/completions ke baseURL, jadi /v1 harus sudah ada. Tanpa itu, OpenCode berhenti dengan Not Found saja.

Menambahkan Claude

Tambahkan penyedia kedua di dalam provider dengan paket Anthropic dan kunci dari grup Claude:

"claude": {
  "npm": "@ai-sdk/anthropic",
  "name": "APICLAN Claude",
  "options": {
    "baseURL": "https://apiclan.us/v1",
    "apiKey": "{env:APICLAN_CLAUDE_KEY}"
  },
  "models": { "claude-fable-5-1": {} }
}

Di sini pun baseURL harus diakhiri /v1: paket Anthropic hanya menambahkan /messages, dan https://apiclan.us saja mengembalikan 404 dalam uji kami. Ini kebalikan dari Claude Code, yang ANTHROPIC_BASE_URL-nya tidak boleh memuat /v1.

Biaya satu balasan pendek

Kami meminta OpenCode “Reply with just OK” di proyek kosong. Semua model mengirim dua permintaan: satu untuk memberi judul sesi, dan satu lagi jawaban sebenarnya yang membawa prompt sistem dan definisi alat OpenCode.

Model	Permintaan	Token masukan (judul + balasan)	Waktu total	Biaya
gpt-6-astra	2	4,640 + 7,678	20.5 s	$0.050
deepseek-v4-pro	2	528 + 5,708	34.1 s	$0.005
deepseek-v4.1-flash	2	529 + 3,027	21.8 s	$0.0006

OpenCode mengirim prompt sistem yang jauh lebih panjang ke model GPT (sekitar 7.700 token) dibanding ke DeepSeek (sekitar 3.000), dan permintaan judul saja memakai 4.640 token di GPT. Itulah sebabnya “OK” yang sama berbiaya sekitar 77 kali lipat di gpt-6-astra dibanding deepseek-v4.1-flash. Diuji 12 Oktober 2026 dengan OpenCode 1.19.0; biaya sesuai tagihan gateway kami.

Pangkas biaya tambahan dengan small_model

OpenCode memakai small_model untuk pekerjaan sampingan seperti judul sesi. Arahkan ke model murah di penyedianya sendiri:

"small_model": "apiclan-ds/deepseek-v4.1-flash",
"provider": {
  "apiclan": { ... },
  "apiclan-ds": {
    "npm": "@ai-sdk/openai-compatible",
    "options": {
      "baseURL": "https://apiclan.us/v1",
      "apiKey": "{env:APICLAN_DS_KEY}"
    },
    "models": { "deepseek-v4.1-flash": {} }
  }
}

Dengan gpt-6-astra sebagai model utama, permintaan judul turun dari $0,0187 menjadi $0,00003, dan seluruh percakapan satu kata dari $0,050 menjadi $0,031 — 38% lebih hemat di setiap sesi baru, tanpa mengubah jawaban.

Tugas koding kecil

Tugas yang sama untuk tiap model: menulis fizzbuzz.py beserta tes pytest, tanpa menjalankan perintah. Setelah itu kami mencocokkan tiap fungsi dengan keluaran yang benar untuk 1–30.

Model	Permintaan	Waktu total	Biaya	Benar	Jumlah assert tes
gpt-6-astra	3	40 s	$0.069	✓	2
deepseek-v4-pro	3	61 s	$0.008	✓	7
deepseek-v4.1-flash	3	25 s	$0.0011	✓	7

Ketiganya menulis kode yang benar dalam tiga permintaan. deepseek-v4.1-flash paling cepat dan biayanya sekitar 1/60 dari gpt-6-astra; kedua model DeepSeek juga menulis tes yang lebih lengkap. deepseek-v4-pro paling lambat karena berpikir sebelum setiap langkah. Waktu total sudah termasuk beberapa detik waktu mulai OpenCode sendiri.

Galat umum

• Not Found → baseURL tanpa /v1.
• 401 → kuncinya salah, atau variabel lingkungan di apiKey belum disetel di terminal yang menjalankan OpenCode.
• 404 model_not_found (is not supported by any configured account in this group) → model di models tidak ada di grup kunci, misalnya model GPT pada penyedia yang memakai kunci DeepSeek.
• Bad Gateway setelah menunggu lama → penyedia hulu sedang tidak tersedia. OpenCode mencoba ulang sendiri beberapa kali sebelum menyerah; cukup kirim ulang prompt-nya.

Alat koding lain: Cline dengan API kustom · Codex dengan API kustom.

Mulai gunakan

Tanpa langganan, tanpa minimum bulanan, tanpa panggilan sales. Isi saldo dengan USDT dan pakai sesuai kebutuhan — 1 USDT memberi Anda 2 kredit saldo API.

Baca panduan cepat 30 detik

Bahasa: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Harga di halaman ini diisi otomatis dari data penagihan nyata. Ketentuan pihak ketiga dikutip dari dokumentasi mereka sendiri.