Nyumbani / Miongozo / Tumia OpenCode kwa free LLM API

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 | bash

Fungua 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>
opencode

Amri hufanya mambo matatu:

  • Inaongeza mtoa huduma wa freellmapi kwenye ~/.config/opencode/opencode.json. Mtoa huduma huorodhesha model kutoka katalogi yako ya moja kwa moja pamoja na mipaka yao ya muktadha.
  • Inaweka freellmapi/auto kama 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.context ni idadi ya juu ya input tokens za model. limit.output ni idadi ya juu ya tokens inazoweza kutengeneza.
  • model ya ngazi ya juu hutumia muundo wa provider/model. Bila hiyo, OpenCode huweka model iliyotumika awali.
  • Kila kitambulisho cha model unachotaka kutumia lazima kiwe kwenye ramani ya models. Ongeza vitambulisho zaidi kutoka GET /v1/models.
Kumbuka kuhusu matoleo ya config: nyaraka za OpenCode sasa zinaelezea muundo wa config wa V2 wenye ufunguo wa 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.

Model za bure kwa OpenCode: tool calling na muktadha wa 128K+
ModeliBure kwenyeMuktadhaVikomo vya bure (ofa bora)ZanaUoni
GLM 5.3UnoRouter1M1 maombi/dakika
1 req/min per model
NdiyoHapana
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 maombi/dakika
40 RPM
NdiyoNdiyo
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaNdiyoNdiyo
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceNdiyoHapana
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditNdiyoNdiyo
Gemini 3.7 FlashGoogle AI Studio1M10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditNdiyoNdiyo
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 maombi/dakika
50 maombi/siku
50 req/day account-wide (1,000 after a $10 purchase)
NdiyoNdiyo
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 maombi/dakika
50 maombi/siku
Shared rate limit
NdiyoHapana
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 maombi/dakika
250 maombi/siku
70,000 tokeni/dakika
~6M
NdiyoNdiyo
Gemini 3.6 FlashGoogle AI Studio1M10 maombi/dakika
20 maombi/siku
250,000 tokeni/dakika
~3M
NdiyoNdiyo
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayNdiyoNdiyo

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_switch kwenye .env ya 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

TatizoChanzoSuluhisho
"Invalid API key" wakati ufunguo ni sahihiapiKey tupu kwenye config inabatilisha ufunguo kutoka /connectOndoa apiKey kutoka options, au endesha setup-opencode tena
OpenCode haitumii mtoa huduma mpyamodel ya ngazi ya juu haijawekwaWeka "model": "freellmapi/auto"
Model haijapatikanaKitambulisho cha model hakimo kwenye ramani ya models ya mtoa hudumaOngeza kitambulisho kwenye ramani, au endesha setup-opencode tena
Ufunguo wa {env:VAR} ni tupuOpenCode hubadilisha variable isiyowekwa kuwa mfuatano tupuExport variable kwenye shell hiyo hiyo, au hifadhi ufunguo kwa /connect
Simu za zana zinashindwaModel ina tool calling dhaifuChagua model kutoka jedwali lililo hapo juu
Ujumbe wa hitilafu: "All models rate-limited after N attempts"Funguo zote zimefikia kikomo chakeOngeza funguo kutoka watoa huduma zaidi, au subiri muda wa kupumzika
Tumia kila moja ya hizi kwa ufunguo mmoja. FreeLLMAPI ni kipanga njia huria, unachoendesha mwenyewe. Kinaweka tabaka hizi zote za bure nyuma ya kituo kimoja cha OpenAI kinachooana, na kinahamia kwenye nyingine pale kikomo kinapofikiwa. Vinjari katalogi au anza sasa.

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

Vyanzo

Miongozo yote · Tazama modeli zote za bure