मुफ़्त LLM API के साथ OpenCode उपयोग करें
OpenCode terminal और desktop के लिए एक open-source coding agent है। यह किसी भी OpenAI-compatible provider को स्वीकार करता है। यह guide OpenCode को FreeLLMAPI के माध्यम से मुफ़्त models से जोड़ती है। एक command config लिखता है और key सहेजता है।
कोड, मॉडल नाम और लाइव कैटलॉग लेबल अंग्रेज़ी में दिखाए गए हैं।
चरण 1: FreeLLMAPI इंस्टॉल करें
FreeLLMAPI एक open-source gateway है। यह आपके कंप्यूटर पर Docker में चलता है और 45 providers के मुफ़्त tiers को एक key के पीछे जोड़ता है।
macOS या Linux पर इंस्टॉल करें
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001 खोलें। Keys page पर कम से कम दो मुफ़्त provider keys जोड़ें। Google AI Studio और Groq, दोनों कुछ मिनटों में मुफ़्त key देते हैं। उसी page से अपनी unified key कॉपी करें।
चरण 2: एक command से OpenCode जोड़ें
एक command
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यह command तीन काम करता है:
- यह
freellmapiprovider को~/.config/opencode/opencode.jsonमें जोड़ता है। Provider आपकी live catalog के models को उनकी context limits के साथ सूचीबद्ध करता है। - यह
freellmapi/autoको डिफ़ॉल्ट model के रूप में सेट करता है। - यह key को OpenCode की credential file,
~/.local/share/opencode/auth.jsonमें सहेजता है। CLI में या desktop app में, आपको environment variable की आवश्यकता नहीं है।
Command लिखने से पहले backup बनाता है। यह नए provider को मौजूदा config में मिलाता है, इसलिए आपके अन्य providers बने रहते हैं। यदि XDG_CONFIG_HOME या XDG_DATA_HOME सेट है, तो command उन folders का उपयोग करता है।
लंबा task शुरू करने से पहले जांच लें कि gateway अभी अनुरोध पूरा कर सकता है। यह call केवल उन models को सूचीबद्ध करता है जिनकी इस समय उपयोग योग्य key है:
जांचें कौन से models तैयार हैं
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"जिस model की status exhausted है, उसकी keys हैं, पर उनमें से सभी अभी अपनी limit पर हैं। Cooldowns समाप्त होने पर यह status साफ़ हो जाती है। यह सुनिश्चित करने के लिए कि client के अनुरोध gateway तक पहुंचते हैं, npx freellmapi doctor चलाएं। Dashboard का request log OpenCode से हर call दिखाता है। X-Routed-Via response header उस provider और model का नाम देता है जिसने हर अनुरोध का उत्तर दिया। यदि कोई अनुरोध fail over हुआ, तो X-Fallback-Trail header हर विफल hop और उसका कारण बताता है।
हाथ से सेटअप: opencode.json provider block
हाथ से सेट करने के लिए, यह block ~/.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 चुनें और अपनी unified key पेस्ट करें। /connect में provider id config की id से मेल खानी चाहिए। Model चुनने के लिए /models चलाएं।
limit.contextmodel के अधिकतम input tokens हैं।limit.outputवे अधिकतम tokens हैं जो वह उत्पन्न कर सकता है।- ऊपर-स्तर का
modelprovider/modelफ़ॉर्मेट उपयोग करता है। इसके बिना, OpenCode वही model रखता है जो उसने पहले उपयोग किया था। - हर model id जिसे आप उपयोग करना चाहते हैं,
modelsmap में होनी चाहिए।GET /v1/modelsसे और ids जोड़ें।
providers key वाले V2 config format का वर्णन करते हैं। Docs कहते हैं कि ऊपर का V1 format समर्थित बना रहता है। FreeLLMAPI setup command V1 format लिखता है।OpenCode के लिए models चुनें
OpenCode एक agent है। यह tool calls के माध्यम से फ़ाइलें पढ़ता है, उन्हें संपादित करता है और commands चलाता है। हर अनुरोध में system prompt, tool definitions और फ़ाइलों की सामग्री होती है। 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 उपयोग करें। Intelligence या गति के अनुसार अनुरोधों को निर्देशित करने के लिए auto:smart या auto:fast को models map में जोड़ें। Dashboard पर एक नामित profile बनाने के बाद, आप उसे भी जोड़ सकते हैं, उदाहरण के लिए auto:coding।
Rate limits और लंबे सत्र
एक agent task दर्जनों अनुरोध भेज सकता है। एक मुफ़्त tier लंबे task को जल्दी रोक देता है। FreeLLMAPI हर key के requests और tokens गिनता है। जब एक provider 429 error भेजता है, तो router अनुरोध को chain के अगले model पर भेजता है, और session जारी रहता है।
- चार या अधिक providers की keys जोड़ें। अधिक providers से प्रति दिन अधिक requests मिलते हैं।
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchसेट करके FreeLLMAPI के.envमें context handoff चालू करें। जब model बदलता है, तो अगले model को एक छोटा नोट मिलता है कि वह एक task जारी रख रहा है।- Sticky sessions एक बातचीत को 30 मिनट तक एक model पर रखते हैं। इससे agent एक जैसा रहता है।
- हर task के लिए नया session शुरू करें। छोटे context में हर अनुरोध पर कम tokens लगते हैं।
समस्या निवारण
| समस्या | कारण | समाधान |
|---|---|---|
| सही key के साथ "Invalid API key" | Config में खाली apiKey, /connect की key को ओवरराइड करती है | apiKey को options से हटाएं, या setup-opencode फिर से चलाएं |
| OpenCode नए provider का उपयोग नहीं करता | ऊपर-स्तर का model सेट नहीं है | "model": "freellmapi/auto" सेट करें |
| त्रुटि संदेश: "Model not found" | Model id provider के models map में नहीं है | Id को map में जोड़ें, या setup-opencode फिर से चलाएं |
{env:VAR} key खाली है | OpenCode एक सेट न किए गए variable को खाली string से बदल देता है | उसी shell में variable export करें, या /connect से key सहेजें |
| Tool calls विफल होते हैं | Model में tool calling कमज़ोर है | ऊपर की तालिका से एक model चुनें |
| त्रुटि संदेश: "All models rate-limited after N attempts" | सभी keys अपनी limit पर हैं | अधिक providers की keys जोड़ें, या cooldowns का इंतज़ार करें |
अक्सर पूछे जाने वाले प्रश्न
क्या मैं OpenCode मुफ़्त में उपयोग कर सकता हूं?
हां। OpenCode open source है। इसे OpenAI-compatible provider के रूप में FreeLLMAPI से जोड़ें। Gateway हर अनुरोध मुफ़्त provider tiers को भेजता है, इसलिए inference की लागत $0 है।
मैं OpenCode में कस्टम OpenAI-compatible provider कैसे जोड़ूं?
opencode.json में एक provider जोड़ें जिसका npm @ai-sdk/openai-compatible पर सेट हो, साथ में options.baseURL और एक models map। फिर 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 setup command key वहीं लिखता है, इसलिए CLI और desktop app दोनों उसे पा लेते हैं।
संबंधित गाइड
- मुफ़्त LLM API के साथ Aider इस्तेमाल करें
- मुफ़्त मॉडलों के साथ Codex CLI इस्तेमाल करें
- Claude Code मुफ़्त में कैसे उपयोग करें
- कोडिंग के लिए सबसे अच्छे मुफ़्त 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)