Guna OpenCode dengan API LLM percuma
OpenCode ialah ejen pengekodan sumber terbuka untuk terminal dan desktop. Ia menerima mana-mana penyedia yang serasi dengan OpenAI. Panduan ini menyambungkan OpenCode kepada model percuma melalui FreeLLMAPI. Satu arahan menulis konfigurasi dan menyimpan kunci.
Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.
Langkah 1: Pasang FreeLLMAPI
FreeLLMAPI ialah gerbang sumber terbuka. Ia dijalankan pada komputer anda dalam Docker dan menghimpunkan tier percuma bagi 45 penyedia di sebalik satu kunci.
Pasang pada macOS atau Linux
curl -fsSL https://freellmapi.co/install.sh | bashBuka http://localhost:3001. Tambah sekurang-kurangnya dua kunci penyedia percuma pada halaman Keys. Google AI Studio dan Groq masing-masing memberikan kunci percuma dalam beberapa minit. Salin kunci bersatu anda daripada halaman yang sama.
Langkah 2: Sambungkan OpenCode dengan satu arahan
Satu arahan
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodeArahan ini melakukan tiga perkara:
- Ia menambah penyedia
freellmapipada~/.config/opencode/opencode.json. Penyedia itu menyenaraikan model daripada katalog langsung anda beserta had konteksnya. - Ia menetapkan
freellmapi/autosebagai model lalai. - Ia menyimpan kunci dalam fail kelayakan OpenCode,
~/.local/share/opencode/auth.json. Anda tidak perlukan pembolehubah persekitaran, sama ada dalam CLI atau aplikasi desktop.
Arahan ini membuat sandaran sebelum menulis. Ia menggabungkan penyedia baharu, jadi penyedia lain anda kekal. Jika XDG_CONFIG_HOME atau XDG_DATA_HOME ditetapkan, arahan ini menggunakan folder tersebut.
Sebelum anda memulakan tugasan panjang, pastikan gerbang boleh melayan permintaan sekarang. Panggilan ini hanya menyenaraikan model yang mempunyai kunci boleh guna pada masa ini:
Semak model yang sedia
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Model dengan status exhausted mempunyai kunci, tetapi semuanya telah mencapai had sekarang. Status ini hilang apabila tempoh rehat tamat. Jalankan npx freellmapi doctor untuk memastikan permintaan klien sampai ke gerbang. Log permintaan papan pemuka menunjukkan setiap panggilan daripada OpenCode. Pengepala respons X-Routed-Via menamakan penyedia dan model yang menjawab setiap permintaan. Jika satu permintaan beralih ke penyedia lain, pengepala X-Fallback-Trail menamakan setiap lompatan yang gagal dan sebabnya.
Persediaan manual: blok penyedia opencode.json
Untuk menyediakannya secara manual, tambah blok ini pada ~/.config/opencode/opencode.json, atau pada opencode.json dalam projek anda. OpenCode menggunakan @ai-sdk/openai-compatible untuk titik akhir /v1/chat/completions.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}Kemudian tambah kunci. Mulakan OpenCode, jalankan /connect, pilih penyedia freellmapi dan tampal kunci bersatu anda. ID penyedia dalam /connect mesti sepadan dengan ID dalam konfigurasi. Jalankan /models untuk memilih model.
limit.contextialah bilangan token input maksimum bagi model itu.limit.outputialah bilangan token maksimum yang boleh dijana olehnya.modelperingkat atas menggunakan formatprovider/model. Tanpa ini, OpenCode mengekalkan model yang digunakannya sebelum ini.- Setiap ID model yang anda mahu guna mesti ada dalam peta
models. Tambah lebih banyak ID daripadaGET /v1/models.
providers. Dokumentasi menyatakan bahawa format V1 di atas masih disokong. Arahan persediaan FreeLLMAPI menulis format V1.Pilih model untuk OpenCode
OpenCode ialah ejen. Ia membaca fail, mengeditnya dan menjalankan arahan melalui panggilan alat. Setiap permintaan membawa gesaan sistem, takrif alat dan kandungan fail. Guna model dengan panggilan alat dan tetingkap konteks yang besar.
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 permintaan/minit 1 req/min per model | Ya | Tidak |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 permintaan/minit 40 RPM | Ya | Ya |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ya | Tidak |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 permintaan/minit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Ya |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 permintaan/minit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 permintaan/minit 250 permintaan/hari 70,000 token/minit ~6M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ya | Ya |
Memaparkan 12 daripada 109 model percuma yang sepadan. Lihat semua model.
Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
Guna freellmapi/auto untuk membenarkan penghala memilih model bagi setiap permintaan. Tambah auto:smart atau auto:fast pada peta models untuk mengarahkan permintaan mengikut kecerdasan atau kelajuan. Anda juga boleh menambah profil bernama, contohnya auto:coding, selepas anda mencipta profil itu pada papan pemuka.
Had kadar dan sesi panjang
Satu tugasan ejen boleh menghantar berpuluh permintaan. Satu tier percuma sahaja boleh menghentikan tugasan panjang dengan cepat. FreeLLMAPI mengira permintaan dan token bagi setiap kunci. Apabila satu penyedia menghantar ralat 429, penghala menghantar permintaan itu ke model seterusnya dalam rantaian, dan sesi diteruskan.
- Tambah kunci daripada empat penyedia atau lebih. Lebih banyak penyedia memberikan lebih banyak permintaan sehari.
- Hidupkan serahan konteks dengan
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchdalam.envFreeLLMAPI. Apabila model bertukar, model seterusnya menerima nota ringkas bahawa ia meneruskan satu tugasan. - Sesi melekat mengekalkan satu perbualan pada satu model selama 30 minit. Ini menjadikan ejen konsisten.
- Mulakan sesi baharu bagi setiap tugasan. Konteks yang lebih kecil menggunakan lebih sedikit token bagi setiap permintaan.
Penyelesaian masalah
| Masalah | Punca | Penyelesaian |
|---|---|---|
| "Invalid API key" dengan kunci yang sah | apiKey yang kosong dalam konfigurasi menggantikan kunci daripada /connect | Buang apiKey daripada options, atau jalankan setup-opencode sekali lagi |
| OpenCode tidak menggunakan penyedia baharu | model peringkat atas tidak ditetapkan | Tetapkan "model": "freellmapi/auto" |
| Model not found | ID model tiada dalam peta models penyedia | Tambah ID itu pada peta, atau jalankan setup-opencode sekali lagi |
Kunci {env:VAR} kosong | OpenCode menggantikan pembolehubah yang tidak ditetapkan dengan rentetan kosong | Eksport pembolehubah itu dalam shell yang sama, atau simpan kunci dengan /connect |
| Panggilan alat gagal | Model mempunyai panggilan alat yang lemah | Pilih model daripada jadual di atas |
| "Semua model dihadkan kadar selepas N percubaan" | Semua kunci telah mencapai had | Tambah kunci daripada lebih banyak penyedia, atau tunggu tempoh rehat |
Soalan lazim
Bolehkah saya guna OpenCode secara percuma?
Boleh. OpenCode ialah sumber terbuka. Sambungkannya kepada FreeLLMAPI sebagai penyedia yang serasi dengan OpenAI. Gerbang menghantar setiap permintaan ke tier percuma penyedia, jadi kos inferens ialah $0.
Bagaimana saya menambah penyedia OpenAI-compatible tersuai pada OpenCode?
Tambah penyedia pada opencode.json dengan npm ditetapkan kepada @ai-sdk/openai-compatible, options.baseURL dan peta models. Kemudian jalankan /connect untuk menyimpan kunci dan /models untuk memilih model.
Model percuma yang manakah terbaik untuk OpenCode?
Guna model dengan panggilan alat dan sekurang-kurangnya 128K konteks. Jadual dalam halaman ini menunjukkan model percuma terkuat yang memenuhi kedua-dua syarat hari ini. Guna freellmapi/auto untuk membenarkan penghala memilih satu.
Di mana OpenCode menyimpan kunci API?
Kunci yang ditambah dengan /connect pergi ke ~/.local/share/opencode/auth.json. Arahan persediaan FreeLLMAPI menulis kunci di situ, jadi CLI dan aplikasi desktop kedua-duanya menjumpainya.
Panduan berkaitan
- Guna Aider dengan API LLM percuma
- Gunakan Codex CLI dengan model percuma
- Cara guna Claude Code secara percuma
- Model API pengekodan percuma terbaik
- Base URL API percuma yang serasi dengan OpenAI
Sumber
- OpenCode docs: providers (V1 config) (disemak 20 November 2026)
- OpenCode docs: config (disemak 20 November 2026)
- OpenCode docs: migrate from V1 (disemak 20 November 2026)
- FreeLLMAPI CLI generators (disemak 20 November 2026)
- FreeLLMAPI docs: context handoff (disemak 20 November 2026)