முகப்பு / வழிகாட்டிகள் / OpenCode-ஐ இலவச LLM API உடன் பயன்படுத்தவும்

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

http://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

கட்டளை மூன்று செயல்களைச் செய்கிறது:

  • இது freellmapi provider-ஐ ~/.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.
  • மேல்நிலை model provider/model வடிவத்தைப் பயன்படுத்துகிறது. அது இல்லையென்றால், OpenCode முன்பு பயன்படுத்திய model-ஐத் தொடர்கிறது.
  • நீங்கள் பயன்படுத்த விரும்பும் ஒவ்வொரு model id-உம் models map-இல் இருக்க வேண்டும். GET /v1/models-இலிருந்து கூடுதல் ids-ஐச் சேர்க்கவும்.
Config பதிப்புகள் பற்றிய குறிப்பு: OpenCode ஆவணங்கள் இப்போது providers key உடன் ஒரு V2 config வடிவத்தை விவரிக்கின்றன. மேலே உள்ள V1 வடிவம் தொடர்ந்து ஆதரிக்கப்படுகிறது என்று ஆவணங்கள் கூறுகின்றன. FreeLLMAPI அமைவு கட்டளை V1 வடிவத்தை எழுதுகிறது.

OpenCode-க்கான models-ஐத் தேர்ந்தெடுக்கவும்

OpenCode ஒரு முகவர். அது கோப்புகளைப் படிக்கிறது, திருத்துகிறது, tool calls மூலம் கட்டளைகளை இயக்குகிறது. ஒவ்வொரு கோரிக்கையும் ஒரு system prompt, tool வரையறைகள் மற்றும் கோப்பு உள்ளடக்கங்களைச் சுமந்து செல்கிறது. 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-ஐப் பயன்படுத்தவும். நுண்ணறிவு அல்லது வேகத்தின் அடிப்படையில் கோரிக்கைகளை வழிநடத்த 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-க்காகக் காத்திருக்கவும்
இவை அனைத்தையும் ஒரே விசை மூலம் பயன்படுத்துங்கள். FreeLLMAPI என்பது திறந்த மூலமான, நீங்களே நிறுவும் ரூட்டர். இந்த இலவச அடுக்குகள் அனைத்தையும் ஒரே OpenAI-இணக்கமான இறுதிப்புள்ளிக்குப் பின்னால் வைக்கிறது. ஒரு வழங்குநர் வரம்பை எட்டும்போது தானாக அடுத்ததற்கு மாறுகிறது. பட்டியலைப் பார்க்கவும் அல்லது நேரலைக்குச் செல்லவும்.

அடிக்கடி கேட்கப்படும் கேள்விகள்

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 இரண்டும் அதைக் கண்டறிகின்றன.

தொடர்புடைய வழிகாட்டிகள்

ஆதாரங்கள்

அனைத்து வழிகாட்டிகள் · அனைத்து இலவச மாதிரிகளையும் பார்க்கவும்