హోమ్ / గైడ్‌లు / OpenCode ను ఉచిత LLM API తో ఉపయోగించండి

OpenCode ను ఉచిత LLM API తో ఉపయోగించండి

OpenCode టెర్మినల్ మరియు డెస్క్‌టాప్ కోసం ఒక ఓపెన్-సోర్స్ కోడింగ్ ఏజెంట్. ఇది ఏ OpenAI-అనుకూల provider నైనా అంగీకరిస్తుంది. ఈ గైడ్ OpenCode ను FreeLLMAPI ద్వారా ఉచిత మోడల్‌లకు కనెక్ట్ చేస్తుంది. ఒక command config ను వ్రాసి కీని నిల్వ చేస్తుంది.

కోడ్, మోడల్ పేర్లు మరియు ప్రత్యక్ష కేటలాగ్ లేబుల్‌లు ఇంగ్లీషులోనే చూపబడతాయి.

దశ 1: FreeLLMAPI ఇన్‌స్టాల్ చేయండి

FreeLLMAPI ఒక ఓపెన్-సోర్స్ గేట్‌వే. ఇది మీ కంప్యూటర్‌లో Docker లో నడుస్తుంది మరియు 45 ప్రొవైడర్ల ఉచిత టియర్‌లను ఒకే కీ వెనుక కలుపుతుంది.

macOS లేదా Linux లో ఇన్‌స్టాల్ చేయండి

curl -fsSL https://freellmapi.co/install.sh | bash

http://localhost:3001 తెరవండి. Keys పేజీలో కనీసం రెండు ఉచిత ప్రొవైడర్ కీలను జోడించండి. Google AI Studio మరియు Groq ప్రతి ఒక్కటి కొన్ని నిమిషాల్లో ఉచిత కీ ఇస్తాయి. అదే పేజీ నుండి మీ ఏకీకృత కీని కాపీ చేయండి.

దశ 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 మీ లైవ్ కేటలాగ్ నుండి మోడల్‌లను వాటి context limits తో జాబితా చేస్తుంది.
  • ఇది freellmapi/auto ను డిఫాల్ట్ మోడల్‌గా సెట్ చేస్తుంది.
  • ఇది కీని OpenCode యొక్క credential ఫైల్ ~/.local/share/opencode/auth.json లో నిల్వ చేస్తుంది. CLI లో లేదా డెస్క్‌టాప్ యాప్‌లో, మీకు environment variable అవసరం లేదు.

command వ్రాయడానికి ముందు బ్యాకప్ తీసుకుంటుంది. ఇది కొత్త provider ను విలీనం చేస్తుంది, కాబట్టి మీ ఇతర providers ఉంటాయి. XDG_CONFIG_HOME లేదా XDG_DATA_HOME సెట్ చేసి ఉంటే, command ఆ ఫోల్డర్‌లను ఉపయోగిస్తుంది.

పొడవైన టాస్క్ ప్రారంభించే ముందు, గేట్‌వే ఇప్పుడే ఒక అభ్యర్థనకు సేవ చేయగలదని నిర్ధారించుకోండి. ఈ కాల్ ఈ క్షణంలో ఉపయోగించగల కీ ఉన్న మోడల్‌లను మాత్రమే జాబితా చేస్తుంది:

ఏ మోడల్‌లు సిద్ధంగా ఉన్నాయో తనిఖీ చేయండి

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

exhausted స్థితి ఉన్న మోడల్‌కు కీలు ఉన్నాయి, కానీ అన్నీ ఇప్పుడు ఒక పరిమితిలో ఉన్నాయి. cooldowns ముగిసినప్పుడు ఈ స్థితి క్లియర్ అవుతుంది. క్లయింట్ అభ్యర్థనలు గేట్‌వేకు చేరుతున్నాయని నిర్ధారించుకోవడానికి npx freellmapi doctor నడపండి. డాష్‌బోర్డ్ request log OpenCode నుండి ప్రతి కాల్‌ను చూపుతుంది. X-Routed-Via response హెడర్ ప్రతి అభ్యర్థనకు సమాధానం ఇచ్చిన ప్రొవైడర్ మరియు మోడల్‌ను పేర్కొంటుంది. ఒక అభ్యర్థన failover అయితే, X-Fallback-Trail హెడర్ విఫలమైన ప్రతి hop ను మరియు కారణాన్ని పేర్కొంటుంది.

మానవీయ సెటప్: opencode.json provider బ్లాక్

మానవీయంగా సెటప్ చేయడానికి, ఈ బ్లాక్‌ను ~/.config/opencode/opencode.json కు, లేదా మీ ప్రాజెక్ట్‌లోని 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 }
        }
      }
    }
  }
}

తర్వాత కీని జోడించండి. OpenCode ప్రారంభించి, /connect నడపండి, freellmapi provider ను ఎంచుకోండి మరియు మీ ఏకీకృత కీని అతికించండి. /connect లోని provider ID config లోని ID తో సరిపోలాలి. మోడల్‌ను ఎంచుకోవడానికి /models నడపండి.

  • limit.context అనేది మోడల్ యొక్క గరిష్ట input tokens. limit.output అనేది అది ఉత్పత్తి చేయగల గరిష్ట tokens.
  • టాప్-లెవల్ model provider/model ఫార్మాట్‌ను ఉపయోగిస్తుంది. అది లేకుండా, OpenCode ముందు ఉపయోగించిన మోడల్‌నే ఉంచుతుంది.
  • మీరు ఉపయోగించాలనుకునే ప్రతి మోడల్ ID models map లో ఉండాలి. GET /v1/models నుండి మరిన్ని IDs జోడించండి.
config వెర్షన్ల గమనిక: OpenCode డాక్స్ ఇప్పుడు providers కీతో V2 config ఫార్మాట్‌ను వివరిస్తాయి. పైన ఉన్న V1 ఫార్మాట్ ఇంకా మద్దతు పొందుతుందని డాక్స్ చెబుతాయి. FreeLLMAPI setup command V1 ఫార్మాట్‌ను వ్రాస్తుంది.

OpenCode కోసం మోడల్‌లను ఎంచుకోండి

OpenCode ఒక ఏజెంట్. ఇది tool calls ద్వారా ఫైళ్లను చదువుతుంది, సవరిస్తుంది మరియు commands నడుపుతుంది. ప్రతి అభ్యర్థనలో system prompt, tool definitions మరియు ఫైల్ కంటెంట్‌లు ఉంటాయి. tool calling మరియు పెద్ద context window ఉన్న మోడల్‌లను ఉపయోగించండి.

OpenCode కోసం ఉచిత మోడల్‌లు: tool calling మరియు 128K+ కాంటెక్స్ట్
మోడల్ఉచితంగా లభ్యంకాంటెక్స్ట్ఉచిత పరిమితులు (ఉత్తమ ఆఫర్)సాధనాలువిజన్
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 న తనిఖీ చేయబడింది). ఉచిత పరిమితులు తరచుగా మారుతాయి. కేటలాగ్ ప్రతి రోజు తనిఖీ చేయబడుతుంది.

ప్రతి అభ్యర్థనకు మోడల్‌ను రౌటర్ ఎంచుకోవాలంటే freellmapi/auto ఉపయోగించండి. ఇంటెలిజెన్స్ లేదా వేగం ప్రకారం అభ్యర్థనలను నడిపించడానికి auto:smart లేదా auto:fast ను models map కు జోడించండి. డాష్‌బోర్డ్‌లో మీరు తయారు చేసిన తర్వాత, auto:coding వంటి పేరున్న profile ను కూడా జోడించవచ్చు.

పరిమితులు మరియు పొడవైన సెషన్‌లు

ఒక ఏజెంట్ టాస్క్ డజన్ల కొద్దీ అభ్యర్థనలు పంపవచ్చు. ఒకే ఉచిత టియర్ పొడవైన టాస్క్‌ను త్వరగా ఆపుతుంది. FreeLLMAPI ప్రతి కీ యొక్క అభ్యర్థనలను మరియు tokens ను లెక్కిస్తుంది. ఒక ప్రొవైడర్ 429 ఎర్రర్ పంపినప్పుడు, రౌటర్ అభ్యర్థనను గొలుసులోని తదుపరి మోడల్‌కు పంపుతుంది, మరియు సెషన్ కొనసాగుతుంది.

  • నాలుగు లేదా ఎక్కువ ప్రొవైడర్ల కీలను జోడించండి. ఎక్కువ ప్రొవైడర్లు రోజుకు ఎక్కువ అభ్యర్థనలను ఇస్తారు.
  • FREELLMAPI_CONTEXT_HANDOFF=on_model_switch తో context handoff ను FreeLLMAPI .env లో ఆన్ చేయండి. మోడల్ మారినప్పుడు, తదుపరి మోడల్ ఒక టాస్క్‌ను కొనసాగిస్తోందని చెప్పే చిన్న గమనికను పొందుతుంది.
  • Sticky sessions ఒక సంభాషణను 30 నిమిషాల పాటు ఒకే మోడల్‌పై ఉంచుతాయి. ఇది ఏజెంట్‌ను స్థిరంగా ఉంచుతుంది.
  • ప్రతి టాస్క్ కోసం కొత్త సెషన్ ప్రారంభించండి. చిన్న context ప్రతి అభ్యర్థనకు తక్కువ tokens ఉపయోగిస్తుంది.

సమస్య పరిష్కారం

సమస్యకారణంపరిష్కారం
చెల్లుబాటు అయ్యే కీతో "Invalid API key"config లోని ఖాళీ apiKey /connect నుండి కీని భర్తీ చేస్తుందిapiKey ను options నుండి తొలగించండి, లేదా setup-opencode ను మళ్లీ నడపండి
OpenCode కొత్త provider ను ఉపయోగించడం లేదుటాప్-లెవల్ model సెట్ చేయబడలేదు"model": "freellmapi/auto" సెట్ చేయండి
మోడల్ కనుగొనబడలేదుమోడల్ ID provider యొక్క models map లో లేదుID ను map కు జోడించండి, లేదా setup-opencode ను మళ్లీ నడపండి
{env:VAR} కీ ఖాళీగా ఉందిసెట్ కాని variable ను OpenCode ఖాళీ స్ట్రింగ్‌తో భర్తీ చేస్తుందిఅదే shell లో variable ను export చేయండి, లేదా /connect తో కీని నిల్వ చేయండి
Tool calls విఫలమవుతాయిమోడల్ tool calling బలహీనంగా ఉందిపై పట్టిక నుండి ఒక మోడల్‌ను ఎంచుకోండి
"All models rate-limited after N attempts" (N ప్రయత్నాల తర్వాత అన్ని మోడల్‌లు పరిమితిలో ఉన్నాయి)అన్ని కీలు తమ పరిమితిలో ఉన్నాయిమరిన్ని ప్రొవైడర్ల కీలను జోడించండి, లేదా cooldowns కోసం వేచి ఉండండి
ఇవన్నీ ఒకే కీ ద్వారా ఉపయోగించండి. FreeLLMAPI ఒక ఓపెన్-సోర్స్, సెల్ఫ్-హోస్ట్ రూటర్. ఇది ఈ ఉచిత టియర్‌లన్నింటినీ ఒకే OpenAI-అనుకూల ఎండ్‌పాయింట్ వెనుక ఉంచుతుంది. ఒకటి రేట్ లిమిట్ అయినప్పుడు, అది మరొక దానికి మారుతుంది. కేటలాగ్‌ను బ్రౌజ్ చేయండి లేదా ప్రత్యక్షంగా.

తరచుగా అడిగే ప్రశ్నలు

OpenCode ను ఉచితంగా ఉపయోగించవచ్చా?

అవును. OpenCode ఓపెన్ సోర్స్. దానిని OpenAI-అనుకూల provider గా FreeLLMAPI కు కనెక్ట్ చేయండి. గేట్‌వే ప్రతి అభ్యర్థనను ఉచిత ప్రొవైడర్ టియర్‌లకు పంపుతుంది, కాబట్టి inference ఖర్చు $0.

OpenCode కు కస్టమ్ OpenAI-అనుకూల provider ను ఎలా జోడించాలి?

opencode.json కు npm ను @ai-sdk/openai-compatible కు, options.baseURL మరియు models map తో provider ను జోడించండి. తర్వాత కీని నిల్వ చేయడానికి /connect, మరియు మోడల్‌ను ఎంచుకోవడానికి /models నడపండి.

OpenCode కు ఏ ఉచిత మోడల్ ఉత్తమం?

tool calling మరియు కనీసం 128K context ఉన్న మోడల్‌ను ఉపయోగించండి. ఈ పేజీలోని పట్టిక నేడు ఈ రెండు నియమాలను పాటించే అత్యంత శక్తివంతమైన ఉచిత మోడల్‌లను చూపుతుంది. ఒకదాన్ని రౌటర్ ఎంచుకోవాలంటే freellmapi/auto ఉపయోగించండి.

OpenCode API కీలను ఎక్కడ నిల్వ చేస్తుంది?

/connect తో జోడించిన కీలు ~/.local/share/opencode/auth.json కు వెళ్తాయి. FreeLLMAPI setup command కీని అక్కడ వ్రాస్తుంది, కాబట్టి CLI మరియు డెస్క్‌టాప్ యాప్ రెండూ దానిని కనుగొంటాయి.

సంబంధిత గైడ్‌లు

మూలాలు

అన్ని గైడ్‌లు · అన్ని ఉచిత మోడల్‌లను చూడండి