Folosiți OpenCode cu un API LLM gratuit
OpenCode este un agent de programare open source pentru terminal și desktop. Acceptă orice furnizor compatibil OpenAI. Acest ghid conectează OpenCode la modele gratuite prin FreeLLMAPI. O singură comandă scrie configurația și salvează cheia.
Codul, numele modelelor și etichetele live din catalog sunt afișate în engleză.
Pasul 1: Instalați FreeLLMAPI
FreeLLMAPI este un gateway open source. Rulează pe computer, în Docker, și grupează nivelurile gratuite ale 45 furnizori sub o singură cheie.
Instalare pe macOS sau Linux
curl -fsSL https://freellmapi.co/install.sh | bashDeschideți http://localhost:3001. Adăugați cel puțin două chei de furnizori gratuiți pe pagina Keys. Google AI Studio și Groq oferă fiecare o cheie gratuită în câteva minute. Copiați cheia unificată din aceeași pagină.
Pasul 2: Conectați OpenCode cu o singură comandă
O singură comandă
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>
opencodeComanda face trei lucruri:
- Adaugă un furnizor
freellmapiîn~/.config/opencode/opencode.json. Furnizorul listează modelele din catalogul activ, cu limitele lor de context. - Setează
freellmapi/autoca model implicit. - Salvează cheia în fișierul de credențiale al OpenCode,
~/.local/share/opencode/auth.json. Nu aveți nevoie de o variabilă de mediu, nici în CLI, nici în aplicația desktop.
Comanda face o copie de rezervă înainte să scrie. Unește noul furnizor cu cei existenți, deci ceilalți furnizori rămân. Dacă XDG_CONFIG_HOME sau XDG_DATA_HOME sunt setate, comanda folosește acele foldere.
Înainte să porniți o sarcină lungă, verificați că gateway-ul poate servi o cerere acum. Acest apel listează doar modelele care au o cheie utilizabilă în acest moment:
Verificați ce modele sunt gata
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Un model cu starea exhausted are chei, dar toate au atins acum o limită. Această stare dispare când se termină perioadele de pauză. Rulați npx freellmapi doctor ca să verificați că cererile unui client ajung la gateway. Jurnalul de cereri din panou arată fiecare apel de la OpenCode. Antetul de răspuns X-Routed-Via indică furnizorul și modelul care au răspuns la fiecare cerere. Dacă o cerere a trecut la alt furnizor, antetul X-Fallback-Trail indică fiecare etapă eșuată și motivul.
Configurare manuală: blocul de furnizor din opencode.json
Pentru configurare manuală, adăugați acest bloc în ~/.config/opencode/opencode.json, sau în opencode.json din proiect. OpenCode folosește @ai-sdk/openai-compatible pentru endpoint-urile /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 }
}
}
}
}
}Apoi adăugați cheia. Porniți OpenCode, rulați /connect, selectați furnizorul freellmapi și lipiți cheia unificată. ID-ul furnizorului din /connect trebuie să fie același cu ID-ul din configurație. Rulați /models ca să selectați un model.
limit.contexteste numărul maxim de tokenuri de intrare ale modelului.limit.outputeste numărul maxim de tokenuri pe care le poate genera.modelde nivel superior folosește formatulprovider/model. Fără el, OpenCode păstrează modelul folosit anterior.- Fiecare ID de model pe care doriți să îl folosiți trebuie să fie în harta
models. Adăugați mai multe ID-uri dinGET /v1/models.
providers. Documentația spune că formatul V1 de mai sus rămâne acceptat. Comanda de configurare FreeLLMAPI scrie formatul V1.Alegeți modele pentru OpenCode
OpenCode este un agent. Citește fișiere, le editează și rulează comenzi prin apeluri de unelte. Fiecare cerere transportă un prompt de sistem, definiții de unelte și conținutul fișierelor. Folosiți modele cu apeluri de unelte și o fereastră de context mare.
| Model | Gratuit pe | Context | Limite gratuite (cea mai bună ofertă) | Instrumente | Viziune |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 cereri/min 1 req/min per model | Da | Nu |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 cereri/min 40 RPM | Da | Da |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Da | Da |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Da | Nu |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 cereri/min 50 cereri/zi 50 req/day account-wide (1,000 after a $10 purchase) | Da | Da |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 cereri/min 50 cereri/zi Shared rate limit | Da | Nu |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 cereri/min 250 cereri/zi 70,000 tokeni/min ~6M | Da | Da |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Da | Da |
Se afișează 12 din 109 modele gratuite care se potrivesc. Vezi toate modelele.
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
Folosiți freellmapi/auto ca routerul să aleagă un model pentru fiecare cerere. Adăugați auto:smart sau auto:fast în harta models pentru a dirija cererile după inteligență sau viteză. Puteți adăuga și un profil numit, de exemplu auto:coding, după ce îl creați în panou.
Limite de cereri și sesiuni lungi
O sarcină a unui agent poate trimite zeci de cereri. Un singur nivel gratuit oprește repede o sarcină lungă. FreeLLMAPI numără cererile și tokenurile fiecărei chei. Când un furnizor trimite o eroare 429, routerul trimite cererea către următorul model din lanț, iar sesiunea continuă.
- Adăugați chei de la patru sau mai mulți furnizori. Mai mulți furnizori dau mai multe cereri pe zi.
- Activați transferul contextului cu
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchîn.envdin FreeLLMAPI. Când modelul se schimbă, următorul model primește o notă scurtă că continuă o sarcină. - Sesiunile sticky păstrează o conversație pe un model timp de 30 de minute. Astfel agentul rămâne consecvent.
- Porniți o sesiune nouă pentru fiecare sarcină. Un context mai mic folosește mai puține tokenuri pe cerere.
Depanare
| Problemă | Cauză | Remediere |
|---|---|---|
| Eroare „Invalid API key” cu o cheie validă | Un apiKey gol din configurație înlocuiește cheia din /connect | Eliminați apiKey din options sau rulați din nou setup-opencode |
| OpenCode nu folosește noul furnizor | model de nivel superior nu este setat | Setați "model": "freellmapi/auto" |
| Modelul nu a fost găsit | ID-ul modelului nu este în harta models a furnizorului | Adăugați ID-ul în hartă sau rulați din nou setup-opencode |
Cheia {env:VAR} este goală | OpenCode înlocuiește o variabilă nesetată cu un șir gol | Exportați variabila în același shell sau salvați cheia cu /connect |
| Apelurile de unelte eșuează | Modelul are apeluri de unelte slabe | Selectați un model din tabelul de mai sus |
| Toate modelele au atins limita de cereri după N încercări | Toate cheile și-au atins limita | Adăugați chei de la mai mulți furnizori sau așteptați perioadele de pauză |
Întrebări frecvente
Pot folosi OpenCode gratuit?
Da. OpenCode este open source. Conectați-l la FreeLLMAPI ca furnizor compatibil OpenAI. Gateway-ul trimite fiecare cerere către nivelurile gratuite ale furnizorilor, deci inferența costă $0.
Cum adaug un furnizor personalizat compatibil OpenAI în OpenCode?
Adăugați în opencode.json un furnizor cu npm setat la @ai-sdk/openai-compatible, options.baseURL și o hartă models. Apoi rulați /connect ca să salvați cheia și /models ca să selectați un model.
Care model gratuit este cel mai bun pentru OpenCode?
Folosiți un model cu apeluri de unelte și cel puțin 128K context. Tabelul de pe această pagină arată cele mai puternice modele gratuite care respectă ambele reguli astăzi. Folosiți freellmapi/auto ca routerul să aleagă unul.
Unde salvează OpenCode cheile API?
Cheile adăugate cu /connect ajung în ~/.local/share/opencode/auth.json. Comanda de configurare FreeLLMAPI scrie cheia acolo, deci atât CLI, cât și aplicația desktop o găsesc.
Ghiduri înrudite
- Folosiți Aider cu un API LLM gratuit
- Folosiți Codex CLI cu modele gratuite
- Cum folosiți Claude Code gratuit
- Cele mai bune API-uri gratuite pentru modele de cod
- URL-uri de bază gratuite compatibile OpenAI
Surse
- OpenCode docs: providers (V1 config) (verificat 20 November 2026)
- OpenCode docs: config (verificat 20 November 2026)
- OpenCode docs: migrate from V1 (verificat 20 November 2026)
- FreeLLMAPI CLI generators (verificat 20 November 2026)
- FreeLLMAPI docs: context handoff (verificat 20 November 2026)