Acasă / Ghiduri / Folosiți OpenCode cu un API LLM gratuit

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

Deschideț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>
opencode

Comanda 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/auto ca 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.context este numărul maxim de tokenuri de intrare ale modelului. limit.output este numărul maxim de tokenuri pe care le poate genera.
  • model de nivel superior folosește formatul provider/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 din GET /v1/models.
Notă despre versiunile configurației: documentația OpenCode descrie acum un format de configurație V2, cu o cheie 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.

Modele gratuite pentru OpenCode: apeluri de unelte și peste 128K context
ModelGratuit peContextLimite gratuite (cea mai bună ofertă)InstrumenteViziune
GLM 5.3UnoRouter1M1 cereri/min
1 req/min per model
DaNu
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 cereri/min
40 RPM
DaDa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaDaDa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceDaNu
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditDaDa
Gemini 3.7 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditDaDa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 cereri/min
50 cereri/zi
50 req/day account-wide (1,000 after a $10 purchase)
DaDa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 cereri/min
50 cereri/zi
Shared rate limit
DaNu
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 cereri/min
250 cereri/zi
70,000 tokeni/min
~6M
DaDa
Gemini 3.6 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayDaDa

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 .env din 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 /connectEliminați apiKey din options sau rulați din nou setup-opencode
OpenCode nu folosește noul furnizormodel de nivel superior nu este setatSetați "model": "freellmapi/auto"
Modelul nu a fost găsitID-ul modelului nu este în harta models a furnizoruluiAdă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 golExportați variabila în același shell sau salvați cheia cu /connect
Apelurile de unelte eșueazăModelul are apeluri de unelte slabeSelectați un model din tabelul de mai sus
Toate modelele au atins limita de cereri după N încercăriToate cheile și-au atins limitaAdăugați chei de la mai mulți furnizori sau așteptați perioadele de pauză
Folosiți fiecare dintre aceste modele printr-o singură cheie. FreeLLMAPI este un router open-source, găzduit de dumneavoastră, care pune toate aceste niveluri gratuite în spatele unui singur endpoint compatibil cu OpenAI și trece la alt furnizor când un furnizor este limitat la rată. Vezi catalogul sau trece live.

Î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

Surse

Toate ghidurile · Vezi toate modelele gratuite