Tumia OpenCode kwa free LLM API
OpenCode ni wakala wa usimbaji wa chanzo huria kwa terminal na kompyuta ya mezani. Inakubali mtoa huduma yeyote anayeoana na OpenAI. Mwongozo huu unaunganisha OpenCode na model za bure kupitia FreeLLMAPI. Amri moja inaandika config na kuhifadhi ufunguo.
Msimbo, majina ya modeli na lebo za katalogi ya moja kwa moja zinaonyeshwa kwa Kiingereza.
Hatua ya 1: Sakinisha FreeLLMAPI
FreeLLMAPI ni lango la chanzo huria. Inaendeshwa kwenye kompyuta yako kwa Docker na kuunganisha viwango vya bure vya watoa huduma 45 nyuma ya ufunguo mmoja.
Sakinisha kwenye macOS au Linux
curl -fsSL https://freellmapi.co/install.sh | bashFungua http://localhost:3001. Ongeza angalau funguo mbili za bure za watoa huduma kwenye ukurasa wa Keys. Google AI Studio na Groq kila moja hutoa ufunguo wa bure ndani ya dakika chache. Nakili ufunguo wako mmoja kutoka ukurasa uleule.
Hatua ya 2: Unganisha OpenCode kwa amri moja
Amri moja
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>
opencodeAmri hufanya mambo matatu:
- Inaongeza mtoa huduma wa
freellmapikwenye~/.config/opencode/opencode.json. Mtoa huduma huorodhesha model kutoka katalogi yako ya moja kwa moja pamoja na mipaka yao ya muktadha. - Inaweka
freellmapi/autokama model chaguo-msingi. - Inahifadhi ufunguo kwenye faili la vitambulisho la OpenCode,
~/.local/share/opencode/auth.json. Hauhitaji variable ya mazingira, kwenye CLI wala kwenye programu ya kompyuta ya mezani.
Amri hufanya nakala ya akiba kabla ya kuandika. Inaunganisha mtoa huduma mpya, kwa hivyo watoa huduma wako wengine wanabaki. Ikiwa XDG_CONFIG_HOME au XDG_DATA_HOME imewekwa, amri inatumia folda hizo.
Kabla ya kuanza kazi ndefu, hakikisha kwamba lango linaweza kuhudumia ombi sasa hivi. Wito huu huorodhesha model zenye ufunguo unaotumika kwa sasa pekee:
Angalia model zilizo tayari
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Model yenye hali exhausted ina funguo, lakini zote zimefikia kikomo sasa. Hali hii hufutwa muda wa kupumzika unapoisha. Endesha npx freellmapi doctor kuhakikisha kwamba maombi ya mteja yanafika kwenye lango. Logi ya maombi ya dashibodi inaonyesha kila wito kutoka OpenCode. Kichwa cha jibu cha X-Routed-Via kinataja mtoa huduma na model iliyojibu kila ombi. Ombi likihamishwa kwa failover, kichwa cha X-Fallback-Trail kinataja kila hatua iliyoshindwa na sababu yake.
Usanidi kwa mkono: kizuizi cha mtoa huduma cha opencode.json
Kusanidi kwa mkono, ongeza kizuizi hiki kwenye ~/.config/opencode/opencode.json, au kwenye opencode.json ya mradi wako. OpenCode hutumia @ai-sdk/openai-compatible kwa endpoints za /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 }
}
}
}
}
}Kisha ongeza ufunguo. Anzisha OpenCode, endesha /connect, chagua mtoa huduma freellmapi na ubandike ufunguo wako mmoja. Kitambulisho cha mtoa huduma kwenye /connect lazima kilingane na kitambulisho kwenye config. Endesha /models kuchagua model.
limit.contextni idadi ya juu ya input tokens za model.limit.outputni idadi ya juu ya tokens inazoweza kutengeneza.modelya ngazi ya juu hutumia muundo waprovider/model. Bila hiyo, OpenCode huweka model iliyotumika awali.- Kila kitambulisho cha model unachotaka kutumia lazima kiwe kwenye ramani ya
models. Ongeza vitambulisho zaidi kutokaGET /v1/models.
providers. Nyaraka zinasema kwamba muundo wa V1 hapo juu bado unaungwa mkono. Amri ya usanidi ya FreeLLMAPI huandika muundo wa V1.Chagua model kwa OpenCode
OpenCode ni wakala. Inasoma faili, kuyahariri na kuendesha amri kupitia simu za zana. Kila ombi hubeba prompt ya mfumo, ufafanuzi wa zana na maudhui ya faili. Tumia model zenye tool calling na dirisha kubwa la muktadha.
| Modeli | Bure kwenye | Muktadha | Vikomo vya bure (ofa bora) | Zana | Uoni |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 maombi/dakika 1 req/min per model | Ndiyo | Hapana |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 maombi/dakika 40 RPM | Ndiyo | Ndiyo |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ndiyo | Ndiyo |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ndiyo | Hapana |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 maombi/dakika 50 maombi/siku 50 req/day account-wide (1,000 after a $10 purchase) | Ndiyo | Ndiyo |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 maombi/dakika 50 maombi/siku Shared rate limit | Ndiyo | Hapana |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 maombi/dakika 250 maombi/siku 70,000 tokeni/dakika ~6M | Ndiyo | Ndiyo |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ndiyo | Ndiyo |
Inaonyesha 12 kati ya 109 modeli za bure zinazolingana. Tazama modeli zote.
Data ya moja kwa moja kutoka katalogi ya FreeLLMAPI (toleo 2026.11.19, imekaguliwa 2026-11-19). Vikomo vya bure hubadilika mara kwa mara. Katalogi hukaguliwa kila siku.
Tumia freellmapi/auto ili router ichague model kwa kila ombi. Ongeza auto:smart au auto:fast kwenye ramani ya models ili kuelekeza maombi kwa akili au kasi. Unaweza pia kuongeza profaili yenye jina, kwa mfano auto:coding, baada ya kuitengeneza kwenye dashibodi.
Vikomo vya viwango na vipindi virefu
Kazi moja ya agent inaweza kutuma maombi kadhaa. Kiwango kimoja cha bure kinasimamisha kazi ndefu haraka. FreeLLMAPI huhesabu maombi na tokens za kila ufunguo. Mtoa huduma akituma hitilafu 429, router hutuma ombi kwa model inayofuata kwenye mnyororo, na kipindi kinaendelea.
- Ongeza funguo kutoka watoa huduma wanne au zaidi. Watoa huduma zaidi hutoa maombi zaidi kwa siku.
- Washa context handoff kwa
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchkwenye.envya FreeLLMAPI. Model inapobadilika, model inayofuata hupokea dokezo fupi kwamba inaendeleza kazi. - Vipindi vya kudumu huweka mazungumzo kwenye model moja kwa dakika 30. Hii inaweka agent thabiti.
- Anzisha kipindi kipya kwa kila kazi. Muktadha mdogo hutumia tokens chache kwa kila ombi.
Utatuzi wa matatizo
| Tatizo | Chanzo | Suluhisho |
|---|---|---|
| "Invalid API key" wakati ufunguo ni sahihi | apiKey tupu kwenye config inabatilisha ufunguo kutoka /connect | Ondoa apiKey kutoka options, au endesha setup-opencode tena |
| OpenCode haitumii mtoa huduma mpya | model ya ngazi ya juu haijawekwa | Weka "model": "freellmapi/auto" |
| Model haijapatikana | Kitambulisho cha model hakimo kwenye ramani ya models ya mtoa huduma | Ongeza kitambulisho kwenye ramani, au endesha setup-opencode tena |
Ufunguo wa {env:VAR} ni tupu | OpenCode hubadilisha variable isiyowekwa kuwa mfuatano tupu | Export variable kwenye shell hiyo hiyo, au hifadhi ufunguo kwa /connect |
| Simu za zana zinashindwa | Model ina tool calling dhaifu | Chagua model kutoka jedwali lililo hapo juu |
| Ujumbe wa hitilafu: "All models rate-limited after N attempts" | Funguo zote zimefikia kikomo chake | Ongeza funguo kutoka watoa huduma zaidi, au subiri muda wa kupumzika |
Maswali yanayoulizwa mara kwa mara
Je, naweza kutumia OpenCode bure?
Ndiyo. OpenCode ni chanzo huria. Iunganishe na FreeLLMAPI kama mtoa huduma anayeoana na OpenAI. Lango hutuma kila ombi kwa viwango vya bure vya watoa huduma, kwa hivyo inference inagharimu $0.
Ninawezaje kuongeza mtoa huduma maalum anayeoana na OpenAI kwenye OpenCode?
Ongeza mtoa huduma kwenye opencode.json mwenye npm iliyowekwa kuwa @ai-sdk/openai-compatible, options.baseURL na ramani ya models. Kisha endesha /connect kuhifadhi ufunguo na /models kuchagua model.
Model ipi ya bure ni bora kwa OpenCode?
Tumia model yenye tool calling na angalau muktadha wa 128K. Jedwali kwenye ukurasa huu linaonyesha model za bure zenye nguvu zaidi zinazotimiza sheria zote mbili leo. Tumia freellmapi/auto ili router ichague moja.
OpenCode huhifadhi wapi funguo za API?
Funguo zilizoongezwa kwa /connect huenda kwenye ~/.local/share/opencode/auth.json. Amri ya usanidi ya FreeLLMAPI huandika ufunguo hapo, kwa hivyo CLI na programu ya kompyuta ya mezani zote zinauona.
Miongozo inayohusiana
- Tumia Aider na API ya bure ya LLM
- Tumia Codex CLI na modeli bure
- Jinsi ya kutumia Claude Code bila malipo
- API bora za bure za modeli za msimbo
- Base URL za free API zinazooana na OpenAI
Vyanzo
- OpenCode docs: providers (V1 config) (imekaguliwa 20 November 2026)
- OpenCode docs: config (imekaguliwa 20 November 2026)
- OpenCode docs: migrate from V1 (imekaguliwa 20 November 2026)
- FreeLLMAPI CLI generators (imekaguliwa 20 November 2026)
- FreeLLMAPI docs: context handoff (imekaguliwa 20 November 2026)