होम / गाइड / मुफ़्त LLM API के साथ OpenCode उपयोग करें

मुफ़्त 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 | bash

http://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 तीन काम करता है:

  • यह freellmapi provider को ~/.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.context model के अधिकतम input tokens हैं। limit.output वे अधिकतम tokens हैं जो वह उत्पन्न कर सकता है।
  • ऊपर-स्तर का model provider/model फ़ॉर्मेट उपयोग करता है। इसके बिना, OpenCode वही model रखता है जो उसने पहले उपयोग किया था।
  • हर model id जिसे आप उपयोग करना चाहते हैं, models map में होनी चाहिए। GET /v1/models से और ids जोड़ें।
Config versions पर नोट: OpenCode docs अब 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 उपयोग करें।

OpenCode के लिए मुफ़्त models: tool calling और 128K+ context
मॉडलमुफ़्त उपलब्धकॉन्टेक्स्टमुफ़्त सीमाएँ (सबसे अच्छा विकल्प)टूलविज़न
GLM 5.3UnoRouter1M1 अनुरोध/मिनट
1 req/min per model
हाँनहीं
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 अनुरोध/मिनट
40 RPM
हाँहाँ
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaहाँहाँ
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceहाँनहीं
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditहाँहाँ
Gemini 3.7 FlashGoogle AI Studio1M10 अनुरोध/मिनट
20 अनुरोध/दिन
250,000 टोकन/मिनट
~3M
हाँहाँ
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditहाँहाँ
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 अनुरोध/मिनट
50 अनुरोध/दिन
50 req/day account-wide (1,000 after a $10 purchase)
हाँहाँ
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 अनुरोध/मिनट
50 अनुरोध/दिन
Shared rate limit
हाँनहीं
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 अनुरोध/मिनट
250 अनुरोध/दिन
70,000 टोकन/मिनट
~6M
हाँहाँ
Gemini 3.6 FlashGoogle AI Studio1M10 अनुरोध/मिनट
20 अनुरोध/दिन
250,000 टोकन/मिनट
~3M
हाँहाँ
Qwen 3.8 27BCloudflare Workers AI262KShared 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 का इंतज़ार करें
इनमें से हर एक का उपयोग एक ही कुंजी से करें। FreeLLMAPI एक ओपन-सोर्स, सेल्फ़-होस्टेड राउटर है। यह इन सभी मुफ़्त टियर को एक OpenAI-संगत एंडपॉइंट के पीछे रखता है। जब कोई एक सीमा पर पहुँचता है, तो यह अगले प्रदाता पर स्विच कर देता है। कैटलॉग देखें या शुरू करें.

अक्सर पूछे जाने वाले प्रश्न

क्या मैं 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 दोनों उसे पा लेते हैं।

संबंधित गाइड

स्रोत

सभी गाइड · सभी मुफ़्त मॉडल देखें