OpenCode ను ఉచిత LLM API తో ఉపయోగించండి
OpenCode టెర్మినల్ మరియు డెస్క్టాప్ కోసం ఒక ఓపెన్-సోర్స్ కోడింగ్ ఏజెంట్. ఇది ఏ OpenAI-అనుకూల provider నైనా అంగీకరిస్తుంది. ఈ గైడ్ OpenCode ను FreeLLMAPI ద్వారా ఉచిత మోడల్లకు కనెక్ట్ చేస్తుంది. ఒక command config ను వ్రాసి కీని నిల్వ చేస్తుంది.
కోడ్, మోడల్ పేర్లు మరియు ప్రత్యక్ష కేటలాగ్ లేబుల్లు ఇంగ్లీషులోనే చూపబడతాయి.
దశ 1: FreeLLMAPI ఇన్స్టాల్ చేయండి
FreeLLMAPI ఒక ఓపెన్-సోర్స్ గేట్వే. ఇది మీ కంప్యూటర్లో Docker లో నడుస్తుంది మరియు 45 ప్రొవైడర్ల ఉచిత టియర్లను ఒకే కీ వెనుక కలుపుతుంది.
macOS లేదా Linux లో ఇన్స్టాల్ చేయండి
curl -fsSL https://freellmapi.co/install.sh | bashhttp://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>
opencodecommand మూడు పనులు చేస్తుంది:
- ఇది
freellmapiprovider ను~/.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.- టాప్-లెవల్
modelprovider/modelఫార్మాట్ను ఉపయోగిస్తుంది. అది లేకుండా, OpenCode ముందు ఉపయోగించిన మోడల్నే ఉంచుతుంది. - మీరు ఉపయోగించాలనుకునే ప్రతి మోడల్ ID
modelsmap లో ఉండాలి.GET /v1/modelsనుండి మరిన్ని IDs జోడించండి.
providers కీతో V2 config ఫార్మాట్ను వివరిస్తాయి. పైన ఉన్న V1 ఫార్మాట్ ఇంకా మద్దతు పొందుతుందని డాక్స్ చెబుతాయి. FreeLLMAPI setup command V1 ఫార్మాట్ను వ్రాస్తుంది.OpenCode కోసం మోడల్లను ఎంచుకోండి
OpenCode ఒక ఏజెంట్. ఇది tool calls ద్వారా ఫైళ్లను చదువుతుంది, సవరిస్తుంది మరియు commands నడుపుతుంది. ప్రతి అభ్యర్థనలో system prompt, tool definitions మరియు ఫైల్ కంటెంట్లు ఉంటాయి. tool calling మరియు పెద్ద context window ఉన్న మోడల్లను ఉపయోగించండి.
| మోడల్ | ఉచితంగా లభ్యం | కాంటెక్స్ట్ | ఉచిత పరిమితులు (ఉత్తమ ఆఫర్) | సాధనాలు | విజన్ |
|---|---|---|---|---|---|
| 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 న తనిఖీ చేయబడింది). ఉచిత పరిమితులు తరచుగా మారుతాయి. కేటలాగ్ ప్రతి రోజు తనిఖీ చేయబడుతుంది.
ప్రతి అభ్యర్థనకు మోడల్ను రౌటర్ ఎంచుకోవాలంటే 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 కోసం వేచి ఉండండి |
తరచుగా అడిగే ప్రశ్నలు
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 మరియు డెస్క్టాప్ యాప్ రెండూ దానిని కనుగొంటాయి.
సంబంధిత గైడ్లు
- ఉచిత LLM APIతో Aider ను ఉపయోగించండి
- ఉచిత మోడళ్లతో Codex CLIని ఉపయోగించండి
- Claude Codeను ఉచితంగా ఎలా ఉపయోగించాలి
- ఉత్తమ ఉచిత కోడింగ్ మోడల్ APIలు
- ఉచిత OpenAI-అనుకూల 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 న తనిఖీ చేయబడింది)