OpenCode gebruiken met een gratis LLM API
OpenCode is een open-source coding-agent voor de terminal en het bureaublad. Het accepteert elke OpenAI-compatibele provider. Deze gids koppelt OpenCode aan gratis modellen via FreeLLMAPI. Eén commando schrijft de configuratie en slaat de sleutel op.
Code, modelnamen en labels uit de live catalogus worden in het Engels getoond.
Stap 1: FreeLLMAPI installeren
FreeLLMAPI is een open-source gateway. Het draait op je computer in Docker en bundelt de gratis tiers van 45 providers achter één sleutel.
Installeren op macOS of Linux
curl -fsSL https://freellmapi.co/install.sh | bashOpen http://localhost:3001. Voeg op de pagina Keys ten minste twee gratis providersleutels toe. Google AI Studio en Groq geven elk binnen enkele minuten een gratis sleutel. Kopieer je uniforme sleutel van dezelfde pagina.
Stap 2: OpenCode verbinden met één commando
Eén commando
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>
opencodeHet commando doet drie dingen:
- Het voegt een provider
freellmapitoe aan~/.config/opencode/opencode.json. De provider toont de modellen uit je actuele catalogus met hun contextlimieten. - Het zet
freellmapi/autoals standaardmodel. - Het slaat de sleutel op in het credentialbestand van OpenCode,
~/.local/share/opencode/auth.json. Je hebt geen omgevingsvariabele nodig, in de CLI noch in de desktopapp.
Het commando maakt een back-up voordat het schrijft. Het voegt de nieuwe provider samen met de bestaande, dus je andere providers blijven bestaan. Als XDG_CONFIG_HOME of XDG_DATA_HOME is ingesteld, gebruikt het commando die mappen.
Controleer voordat je een lange taak start of de gateway nu een aanvraag kan beantwoorden. Deze aanroep toont alleen de modellen die op dit moment een bruikbare sleutel hebben:
Controleer welke modellen klaar zijn
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Een model met de status exhausted heeft sleutels, maar al die sleutels hebben nu hun limiet bereikt. Deze status verdwijnt wanneer de cooldowns eindigen. Voer npx freellmapi doctor uit om zeker te weten dat de aanvragen van een client de gateway bereiken. Het aanvraaglogboek van het dashboard toont elke aanroep vanuit OpenCode. De responseheader X-Routed-Via noemt de provider en het model dat elke aanvraag heeft beantwoord. Is een aanvraag doorgeschakeld, dan noemt de header X-Fallback-Trail elke mislukte stap en de reden.
Handmatige installatie: het providerblok in opencode.json
Om het handmatig in te stellen, voeg je dit blok toe aan ~/.config/opencode/opencode.json, of aan opencode.json in je project. OpenCode gebruikt @ai-sdk/openai-compatible voor /v1/chat/completions-endpoints.
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 }
}
}
}
}
}Voeg daarna de sleutel toe. Start OpenCode, voer /connect uit, selecteer de provider freellmapi en plak je uniforme sleutel. Het provider-id in /connect moet overeenkomen met het id in de configuratie. Voer /models uit om een model te selecteren.
limit.contextis het maximale aantal invoertokens van het model.limit.outputis het maximale aantal tokens dat het kan genereren.- Het
modelop het hoogste niveau gebruikt de notatieprovider/model. Zonder die instelling houdt OpenCode het model aan dat het eerder gebruikte. - Elk model-id dat je wilt gebruiken, moet in de map
modelsstaan. Voeg meer ids toe uitGET /v1/models.
providers. De documentatie zegt dat het V1-formaat hierboven nog wordt ondersteund. Het installatiecommando van FreeLLMAPI schrijft het V1-formaat.Modellen kiezen voor OpenCode
OpenCode is een agent. Het leest bestanden, bewerkt ze en voert opdrachten uit via tool calls. Elke aanvraag bevat een systeemprompt, tooldefinities en bestandsinhoud. Gebruik modellen met tool calling en een groot contextvenster.
| Model | Gratis op | Context | Gratis limieten (beste aanbod) | Tools | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 aanvragen/min 1 req/min per model | Ja | Nee |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 aanvragen/min 40 RPM | Ja | Ja |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ja | Ja |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ja | Nee |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 aanvragen/min 50 aanvragen/dag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 aanvragen/min 50 aanvragen/dag Shared rate limit | Ja | Nee |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 aanvragen/min 250 aanvragen/dag 70,000 tokens/min ~6M | Ja | Ja |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ja | Ja |
Toont 12 van 109 overeenkomende gratis modellen. Bekijk alle modellen.
Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.
Gebruik freellmapi/auto om de router per aanvraag een model te laten kiezen. Voeg auto:smart of auto:fast toe aan de map models om aanvragen te sturen op intelligentie of snelheid. Je kunt ook een eigen profiel toevoegen, bijvoorbeeld auto:coding, nadat je het op het dashboard hebt gemaakt.
Snelheidslimieten en lange sessies
Eén agenttaak kan tientallen aanvragen sturen. Eén gratis tier stopt een lange taak snel. FreeLLMAPI telt de aanvragen en tokens van elke sleutel. Wanneer een provider een 429-fout stuurt, stuurt de router de aanvraag naar het volgende model in de keten, en gaat de sessie door.
- Voeg sleutels van vier of meer providers toe. Meer providers geven meer aanvragen per dag.
- Zet contextoverdracht aan met
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchin het.env-bestand van FreeLLMAPI. Wanneer het model verandert, krijgt het volgende model een korte notitie dat het een taak voortzet. - Sticky sessions houden een gesprek 30 minuten op één model. Zo blijft de agent consistent.
- Start voor elke taak een nieuwe sessie. Een kleinere context gebruikt minder tokens per aanvraag.
Problemen oplossen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
| "Invalid API key" met een geldige sleutel | Een lege apiKey in de configuratie overschrijft de sleutel van /connect | Verwijder apiKey uit options, of voer setup-opencode opnieuw uit |
| OpenCode gebruikt de nieuwe provider niet | Het model op het hoogste niveau is niet ingesteld | Zet "model": "freellmapi/auto" |
| Model not found | Het model-id staat niet in de map models van de provider | Voeg het id toe aan de map, of voer setup-opencode opnieuw uit |
{env:VAR}-sleutel is leeg | OpenCode vervangt een niet-ingestelde variabele door een lege tekst | Exporteer de variabele in dezelfde shell, of sla de sleutel op met /connect |
| Tool calls mislukken | Het model heeft zwakke tool calling | Kies een model uit de tabel hierboven |
| "Alle modellen rate-limited na N pogingen" | Alle sleutels hebben hun limiet bereikt | Voeg sleutels van meer providers toe, of wacht op de cooldowns |
Veelgestelde vragen
Kan ik OpenCode gratis gebruiken?
Ja. OpenCode is open source. Koppel het aan FreeLLMAPI als OpenAI-compatibele provider. De gateway stuurt elke aanvraag naar gratis providertiers, dus de inferentie kost $0.
Hoe voeg ik een eigen OpenAI-compatibele provider toe aan OpenCode?
Voeg een provider toe aan opencode.json met npm ingesteld op @ai-sdk/openai-compatible, options.baseURL en een map models. Voer daarna /connect uit om de sleutel op te slaan en /models om een model te selecteren.
Welk gratis model is het beste voor OpenCode?
Gebruik een model met tool calling en ten minste 128K context. De tabel op deze pagina toont de sterkste gratis modellen die vandaag aan beide regels voldoen. Gebruik freellmapi/auto om de router er een te laten kiezen.
Waar slaat OpenCode API-sleutels op?
Sleutels die je toevoegt met /connect gaan naar ~/.local/share/opencode/auth.json. Het installatiecommando van FreeLLMAPI schrijft de sleutel daarheen, zodat de CLI en de desktopapp hem allebei vinden.
Gerelateerde gidsen
- Aider gebruiken met een gratis LLM-API
- Codex CLI gebruiken met gratis modellen
- Claude Code gratis gebruiken
- Beste gratis API's voor codemodellen
- Gratis OpenAI-compatibele API-basis-URL's
Bronnen
- OpenCode docs: providers (V1 config) (gecontroleerd 20 November 2026)
- OpenCode docs: config (gecontroleerd 20 November 2026)
- OpenCode docs: migrate from V1 (gecontroleerd 20 November 2026)
- FreeLLMAPI CLI generators (gecontroleerd 20 November 2026)
- FreeLLMAPI docs: context handoff (gecontroleerd 20 November 2026)