OpenCode-ஐ இலவச LLM API உடன் பயன்படுத்தவும்
OpenCode என்பது terminal மற்றும் desktop-க்கான open-source code முகவர். எந்த OpenAI-compatible provider-ஐயும் ஏற்கிறது. இந்த வழிகாட்டி OpenCode-ஐ FreeLLMAPI வழியாக இலவச models-உடன் இணைக்கிறது. ஒரு கட்டளை config-ஐ எழுதி key-ஐச் சேமிக்கிறது.
குறியீடு, மாதிரிப் பெயர்கள் மற்றும் நேரடி பட்டியல் லேபிள்கள் ஆங்கிலத்தில் காட்டப்படுகின்றன.
படி 1: FreeLLMAPI-ஐ நிறுவவும்
FreeLLMAPI ஒரு open-source gateway. அது உங்கள் கணினியில் Docker-இல் இயங்கி, 45 வழங்குநர்களின் இலவச அடுக்குகளை ஒரு key பின்னால் இணைக்கிறது.
macOS அல்லது Linux-இல் நிறுவவும்
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001-ஐத் திறக்கவும். Keys பக்கத்தில் குறைந்தது இரண்டு இலவச provider keys-ஐச் சேர்க்கவும். Google AI Studio மற்றும் Groq ஒவ்வொன்றும் சில நிமிடங்களில் ஒரு இலவச key தருகின்றன. அதே பக்கத்திலிருந்து உங்கள் ஒருங்கிணைந்த key-ஐ நகலெடுக்கவும்.
படி 2: ஒரு கட்டளையால் OpenCode-ஐ இணைக்கவும்
ஒரு கட்டளை
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கட்டளை மூன்று செயல்களைச் செய்கிறது:
- இது
freellmapiprovider-ஐ~/.config/opencode/opencode.json-க்குச் சேர்க்கிறது. Provider உங்கள் நேரடி catalog-இலிருந்து models-ஐ அவற்றின் context வரம்புகளுடன் பட்டியலிடுகிறது. - இது
freellmapi/auto-ஐ இயல்புநிலை model ஆக அமைக்கிறது. - இது key-ஐ OpenCode-இன் credential கோப்பில்,
~/.local/share/opencode/auth.json-இல் சேமிக்கிறது. CLI-யிலோ desktop app-இலோ environment variable தேவையில்லை.
எழுதுவதற்கு முன் கட்டளை ஒரு காப்புப் பிரதியை எடுக்கிறது. புதிய provider-ஐ இணைக்கிறது, எனவே உங்கள் மற்ற providers அப்படியே இருக்கும். XDG_CONFIG_HOME அல்லது XDG_DATA_HOME அமைக்கப்பட்டிருந்தால், கட்டளை அந்தக் கோப்புறைகளைப் பயன்படுத்துகிறது.
நீண்ட பணியைத் தொடங்குவதற்கு முன், gateway இப்போது ஒரு கோரிக்கைக்குப் பதிலளிக்க முடியுமா என்று உறுதிசெய்யவும். இந்த அழைப்பு இப்போதே பயன்படுத்தக்கூடிய key உள்ள models-ஐ மட்டுமே பட்டியலிடுகிறது:
எந்த models தயாராக உள்ளன என்று சரிபார்க்கவும்
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"exhausted நிலை உள்ள model-க்கு keys உள்ளன, ஆனால் அவை எல்லாம் இப்போது வரம்பில் உள்ளன. Cooldowns முடியும்போது இந்த நிலை நீங்கும். ஒரு client-இன் கோரிக்கைகள் gateway-ஐ அடைகின்றன என்று உறுதிசெய்ய npx freellmapi doctor-ஐ இயக்கவும். டாஷ்போர்டின் கோரிக்கைப் பதிவு OpenCode-இலிருந்து ஒவ்வொரு அழைப்பையும் காட்டுகிறது. X-Routed-Via response header ஒவ்வொரு கோரிக்கைக்கும் பதிலளித்த provider மற்றும் model-ஐப் பெயரிடுகிறது. ஒரு கோரிக்கை failover ஆனால், X-Fallback-Trail header தோல்வியுற்ற ஒவ்வொரு hop-ஐயும் அதன் காரணத்தையும் பெயரிடுகிறது.
கைமுறை அமைப்பு: opencode.json provider தொகுதி
கைமுறையாக அமைக்க, இந்தத் தொகுதியை ~/.config/opencode/opencode.json-இல் சேர்க்கவும், அல்லது உங்கள் project-இல் உள்ள opencode.json-இல் சேர்க்கவும். OpenCode @ai-sdk/openai-compatible-ஐ /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 }
}
}
}
}
}பிறகு key-ஐச் சேர்க்கவும். OpenCode-ஐத் தொடங்கவும், /connect-ஐ இயக்கவும், freellmapi provider-ஐத் தேர்ந்தெடுத்து உங்கள் ஒருங்கிணைந்த key-ஐ ஒட்டவும். /connect-இல் உள்ள provider id config-இல் உள்ள id-உடன் பொருந்த வேண்டும். Model-ஐத் தேர்ந்தெடுக்க /models-ஐ இயக்கவும்.
limit.contextஎன்பது model-இன் அதிகபட்ச உள்ளீட்டு tokens.limit.outputஎன்பது அது உருவாக்கக்கூடிய அதிகபட்ச tokens.- மேல்நிலை
modelprovider/modelவடிவத்தைப் பயன்படுத்துகிறது. அது இல்லையென்றால், OpenCode முன்பு பயன்படுத்திய model-ஐத் தொடர்கிறது. - நீங்கள் பயன்படுத்த விரும்பும் ஒவ்வொரு model id-உம்
modelsmap-இல் இருக்க வேண்டும்.GET /v1/models-இலிருந்து கூடுதல் ids-ஐச் சேர்க்கவும்.
providers key உடன் ஒரு V2 config வடிவத்தை விவரிக்கின்றன. மேலே உள்ள V1 வடிவம் தொடர்ந்து ஆதரிக்கப்படுகிறது என்று ஆவணங்கள் கூறுகின்றன. FreeLLMAPI அமைவு கட்டளை V1 வடிவத்தை எழுதுகிறது.OpenCode-க்கான models-ஐத் தேர்ந்தெடுக்கவும்
OpenCode ஒரு முகவர். அது கோப்புகளைப் படிக்கிறது, திருத்துகிறது, tool calls மூலம் கட்டளைகளை இயக்குகிறது. ஒவ்வொரு கோரிக்கையும் ஒரு system prompt, tool வரையறைகள் மற்றும் கோப்பு உள்ளடக்கங்களைச் சுமந்து செல்கிறது. Tool calling மற்றும் பெரிய context window உள்ள models-ஐப் பயன்படுத்தவும்.
| மாதிரி | இலவசம் | சூழல் அளவு | இலவச வரம்புகள் (சிறந்த சலுகை) | கருவிகள் | படப் பார்வை |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 கோரிக்கை/நிமிடம் 1 req/min per model | ஆம் | இல்லை |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 கோரிக்கை/நிமிடம் 40 RPM | ஆம் | ஆம் |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | ஆம் | ஆம் |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | ஆம் | இல்லை |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | ஆம் | ஆம் |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 கோரிக்கை/நிமிடம் 20 கோரிக்கை/நாள் 250,000 டோக்கன்/நிமிடம் ~3M | ஆம் | ஆம் |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | ஆம் | ஆம் |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 கோரிக்கை/நிமிடம் 50 கோரிக்கை/நாள் 50 req/day account-wide (1,000 after a $10 purchase) | ஆம் | ஆம் |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 கோரிக்கை/நிமிடம் 50 கோரிக்கை/நாள் Shared rate limit | ஆம் | இல்லை |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 கோரிக்கை/நிமிடம் 250 கோரிக்கை/நாள் 70,000 டோக்கன்/நிமிடம் ~6M | ஆம் | ஆம் |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 கோரிக்கை/நிமிடம் 20 கோரிக்கை/நாள் 250,000 டோக்கன்/நிமிடம் ~3M | ஆம் | ஆம் |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | ஆம் | ஆம் |
பொருந்தும் 109 இலவச மாதிரிகளில் 12 காட்டப்படுகின்றன. அனைத்து மாதிரிகளையும் பார்க்கவும்.
FreeLLMAPI பட்டியலிலிருந்து நேரடி தரவு (பதிப்பு 2026.11.19, சரிபார்க்கப்பட்டது 2026-11-19). இலவச வரம்புகள் அடிக்கடி மாறும். பட்டியல் ஒவ்வொரு நாளும் சரிபார்க்கப்படுகிறது.
ஒவ்வொரு கோரிக்கைக்கும் router ஒரு model-ஐத் தேர்ந்தெடுக்க freellmapi/auto-ஐப் பயன்படுத்தவும். நுண்ணறிவு அல்லது வேகத்தின் அடிப்படையில் கோரிக்கைகளை வழிநடத்த auto:smart அல்லது auto:fast-ஐ models map-இல் சேர்க்கவும். டாஷ்போர்டில் அதை உருவாக்கிய பிறகு, auto:coding போன்ற பெயரிடப்பட்ட profile-ஐயும் சேர்க்கலாம்.
Rate limits மற்றும் நீண்ட sessions
ஒரு முகவர் பணி டஜன் கணக்கான கோரிக்கைகளை அனுப்பலாம். ஒரு இலவச அடுக்கு நீண்ட பணியை விரைவில் நிறுத்திவிடும். FreeLLMAPI ஒவ்வொரு key-யின் கோரிக்கைகளையும் tokens-ஐயும் எண்ணுகிறது. ஒரு provider 429 பிழையை அனுப்பும்போது, router கோரிக்கையை சங்கிலியில் அடுத்த model-க்கு அனுப்புகிறது, session தொடர்கிறது.
- நான்கு அல்லது அதற்கு மேற்பட்ட providers-இன் keys-ஐச் சேர்க்கவும். அதிக providers நாளொன்றுக்கு அதிக கோரிக்கைகளைத் தருகின்றன.
FREELLMAPI_CONTEXT_HANDOFF=on_model_switch-ஐ FreeLLMAPI.env-இல் அமைத்து context handoff-ஐ இயக்கவும். Model மாறும்போது, அடுத்த model ஒரு பணியைத் தொடர்கிறது என்ற குறுகிய குறிப்பைப் பெறுகிறது.- Sticky sessions ஓர் உரையாடலை 30 நிமிடங்களுக்கு ஒரே model-இல் வைத்திருக்கின்றன. இது முகவரை நிலையாக வைத்திருக்கிறது.
- ஒவ்வொரு பணிக்கும் புதிய session-ஐத் தொடங்கவும். சிறிய context ஒவ்வொரு கோரிக்கைக்கும் குறைவான tokens பயன்படுத்துகிறது.
சிக்கல் தீர்வு
| சிக்கல் | காரணம் | தீர்வு |
|---|---|---|
| சரியான key இருந்தும் "Invalid API key" | Config-இல் உள்ள காலியான apiKey, /connect-இலிருந்து key-ஐ மேலெழுதுகிறது | apiKey-ஐ options-இலிருந்து நீக்கவும், அல்லது setup-opencode-ஐ மீண்டும் இயக்கவும் |
| OpenCode புதிய provider-ஐப் பயன்படுத்தவில்லை | மேல்நிலை model அமைக்கப்படவில்லை | "model": "freellmapi/auto"-ஐ அமைக்கவும் |
| Model கிடைக்கவில்லை | Model id provider-இன் models map-இல் இல்லை | Id-ஐ map-இல் சேர்க்கவும், அல்லது setup-opencode-ஐ மீண்டும் இயக்கவும் |
{env:VAR} key காலியாக உள்ளது | அமைக்கப்படாத variable-ஐ OpenCode ஒரு வெற்றுச் சரத்தால் மாற்றுகிறது | அதே shell-இல் variable-ஐ export செய்யவும், அல்லது /connect மூலம் key-ஐ சேமிக்கவும் |
| Tool calls தோல்வியடைகின்றன | Model பலவீனமான tool calling கொண்டது | மேலே உள்ள அட்டவணையிலிருந்து ஒரு model-ஐத் தேர்ந்தெடுக்கவும் |
| "All models rate-limited after N attempts" பிழை | எல்லா keys-உம் அவற்றின் வரம்பில் உள்ளன | அதிக providers-இன் keys-ஐச் சேர்க்கவும், அல்லது cooldowns-க்காகக் காத்திருக்கவும் |
அடிக்கடி கேட்கப்படும் கேள்விகள்
OpenCode-ஐ இலவசமாகப் பயன்படுத்தலாமா?
ஆம். OpenCode open source. அதை OpenAI-compatible provider ஆக FreeLLMAPI-உடன் இணைக்கவும். Gateway ஒவ்வொரு கோரிக்கையையும் இலவச provider அடுக்குகளுக்கு அனுப்புகிறது, எனவே inference செலவு $0.
OpenCode-இல் தனிப்பயன் OpenAI-compatible provider-ஐ எப்படிச் சேர்ப்பது?
opencode.json-இல் npm-ஐ @ai-sdk/openai-compatible ஆக அமைத்து, options.baseURL மற்றும் models map உடன் ஒரு provider-ஐச் சேர்க்கவும். பிறகு key-ஐ சேமிக்க /connect-ஐயும், model-ஐத் தேர்ந்தெடுக்க /models-ஐயும் இயக்கவும்.
OpenCode-க்கு எந்த இலவச model சிறந்தது?
Tool calling மற்றும் குறைந்தது 128K context உள்ள ஒரு model-ஐப் பயன்படுத்தவும். இந்தப் பக்கத்தின் அட்டவணை இன்று இவ்விரண்டு விதிகளையும் பூர்த்தி செய்யும் வலுவான இலவச models-ஐக் காட்டுகிறது. Router ஒன்றைத் தேர்ந்தெடுக்க freellmapi/auto-ஐப் பயன்படுத்தவும்.
OpenCode API keys-ஐ எங்கே சேமிக்கிறது?
/connect மூலம் சேர்க்கப்பட்ட keys ~/.local/share/opencode/auth.json-க்குச் செல்கின்றன. FreeLLMAPI அமைவு கட்டளை key-ஐ அங்கே எழுதுகிறது, எனவே CLI மற்றும் desktop app இரண்டும் அதைக் கண்டறிகின்றன.
தொடர்புடைய வழிகாட்டிகள்
- இலவச LLM API உடன் Aider ஐப் பயன்படுத்துங்கள்
- இலவச மாடல்களுடன் Codex CLI-ஐப் பயன்படுத்துங்கள்
- Claude Code ஐ இலவசமாகப் பயன்படுத்துவது எப்படி
- சிறந்த இலவச coding model APIs
- இலவச OpenAI-compatible API base URLs
ஆதாரங்கள்
- OpenCode docs: providers (V1 config) (சரிபார்க்கப்பட்டது 20 November 2026)
- OpenCode docs: config (சரிபார்க்கப்பட்டது 20 November 2026)
- OpenCode docs: migrate from V1 (சரிபார்க்கப்பட்டது 20 November 2026)
- FreeLLMAPI CLI generators (சரிபார்க்கப்பட்டது 20 November 2026)
- FreeLLMAPI docs: context handoff (சரிபார்க்கப்பட்டது 20 November 2026)
அனைத்து வழிகாட்டிகள் · அனைத்து இலவச மாதிரிகளையும் பார்க்கவும்