Klien/opencode
Menggunakan Wokey API di opencode
Siapkan API key Wokey, arahkan opencode ke base URL Wokey, lalu pastikan koneksinya dengan satu request curl.
Diperbarui
Di halaman iniexpand_more
Siapkan API key dan base URLlink
Semua klien memakai API key Wokey yang sama dan base URL yang sama.
Buat API key
Masuk, lalu buat key platform di halaman API. Semua key dalam satu akun memakai saldo yang sama.
Buat API keykeyGunakan base URL Wokey
Isi base URL klien dengan domain gateway; konfigurasi di bawah menunjukkan apakah /v1 perlu ditambahkan.
Konfigurasikan klienlink
Satu perintah membuat provider Wokey dan mengganti model default ke wokey/auto.
export WOKEY_API_KEY="YOUR_API_KEY"
curl -fsSL https://wokey.ai/downloads/opencode/install.sh | sh
opencodeFormat API dan base URLlink
Saat satu klien berganti format API, base URL bisa berubah antara diakhiri /v1 atau tidak.
| Format | Base URL | Cocok untuk |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek, GLM, Kimi, dan model lainnya |
Lokasi konfigurasi: ~/.config/opencode/opencode.json
Verifikasi dengan curllink
Jika klien menampilkan error, pastikan dulu API key dan base URL benar dengan curl.
opencode secara default memakai format OpenAI Chat Completions. Jika request ini mengembalikan 200, berarti API key dan base URL sudah benar. Ganti YOUR_API_KEY dengan key Anda sebelum mengirimnya.
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'Error dan pemecahan masalahlink
Bedakan dulu kasus autentikasi, saldo, rate limit, ketersediaan model, dan timeout upstream.
invalid api key
Key tidak ada, salah ketik, sudah dihapus, atau header Authorization / x-api-key saling bertentangan.
insufficient balance
Saldo akun terlalu rendah. Isi saldo sebelum mengirim request lagi.
model_denylisted / account_restricted
Panggilan ke model tersebut, atau ke semua model di akun, dijeda setelah pelanggaran berulang. Lihat “Biaya penanganan pelanggaran dan pembatasan”.
request_blocked
Request ini diblokir sebelum sampai ke upstream dan tidak dikenai biaya, misalnya pengiriman ulang tanpa perubahan atas request yang baru saja ditolak model, atau pengguna akhir yang dijeda (X-End-User-Id). Pesan error menyebutkan apa yang diblokir; ubah request sesuai pesan tersebut atau coba lagi nanti. Request lain tidak terpengaruh.
rate limited
Request terlalu sering. Coba lagi nanti atau kurangi konkurensi. Jika hanya satu model, atau satu pengguna akhir (X-End-User-Id), yang terus mengembalikan 429, itu mungkin batas sementara setelah pelanggaran.
client disconnected
Klien menutup koneksi sebelum respons selesai (kode downstream_aborted). Secara default ini gratis. Begitu sebuah akun memiliki setidaknya 50 pemutusan dari sisi klien dalam 24 jam terakhir dan jumlah itu mencapai 10% atau lebih dari request-nya, request terputus berikutnya ditagih sesuai penggunaan yang dilaporkan upstream: input yang diproses, termasuk cache read dan cache write, serta output hanya jika upstream menghitungnya. Pemutusan sebelum upstream melaporkan penggunaan apa pun tetap gratis. Akun diberi tahu saat penagihan dimulai, dan penagihan berhenti otomatis dalam satu jam setelah tingkat pemutusan kembali normal. Penyebab umumnya adalah timeout klien atau proxy yang terlalu singkat, atau program yang membatalkan request sebelum selesai.
upstream unavailable
Layanan model upstream sementara tidak tersedia. Ganti model atau coba lagi nanti.
upstream timeout
Respons upstream melewati batas waktu. Persingkat konteks, kurangi max_tokens, atau coba lagi.
upstream overloaded
Model upstream sementara kelebihan beban dan Wokey sudah mencoba ulang di rute lain (kode upstream_overloaded). Ini tidak berkaitan dengan saldo Anda. Coba lagi sebentar lagi atau ganti model.
Pertanyaan umumlink
- Apa saja yang diubah oleh skrip instalasi?
- Skrip menambahkan provider bernama wokey ke ~/.config/opencode/opencode.json dan mengatur model default ke wokey/auto. File yang sudah ada dicadangkan dulu sebagai opencode.json.bak, dan provider lain di dalamnya tetap dipertahankan.
- Bisakah saya tidak menuliskan API key di perintah?
- Jalankan skrip tanpa mengatur WOKEY_API_KEY, lalu skrip akan meminta key di terminal tanpa menampilkannya. Key disimpan di opencode.json, jadi jangan bagikan file itu.
- Bagaimana cara memakai model tertentu?
- Atur WOKEY_MODEL sebelum menjalankan skrip, misalnya export WOKEY_MODEL=claude-opus-5-5, maka model default menjadi wokey/claude-opus-5-5. Tanpa variabel itu skrip memakai auto.