Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors
OpenCode Integration (Hausa)
🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW
Matsayi: Akwai don amfanin kowa. Masu karatu: Masu gudanarwa da ke haɗa OpenCode da turawar OmniRoute. Tushen gaskiya (tsarin daidaitawa):
src/shared/services/opencodeConfig.tsTushen gaskiya (kunshin npm):@omniroute/opencode-provider/(workspace da za a iya wallafawa)
OpenCode abokin ciniki ne na AI mai wakilci wanda ke aiki ta CLI/desktop. Yana karanta kundin masu samar da sabis daga ~/.config/opencode/opencode.json (ko opencode.jsonc) kuma yana bin tsarin da ke https://opencode.ai/config.json. OmniRoute yana gabatar da kansa ga OpenCode a matsayin ɗaya daga cikin waɗannan masu samar da sabis — kowace buƙata tana bi ta daidaitacciyar fuskar OmniRoute mai dacewa da OpenAI ta /v1, don haka OpenCode yana cin gajiyar turawar Auto-Combo, circuit breakers, manufofin maɓalli, sa ido, da sauransu ta atomatik.
Akwai hanyoyin haɗawa guda biyu da ake tallafawa. Zaɓi ɗaya — dukansu suna samar da daidaitawa iri ɗaya.
Hanya ta 1 — Mai samarwa ta CLI (ba sai an shigar da npm ba)
An ba da shawarar wannan ga masu amfani na ƙarshe. Yana zuwa tare da OmniRoute. Yana rubuta opencode.json kai tsaye a wurinsa.
# Bayan shigar da OmniRoute (npm i -g @omniroute/cli ko kwafin gida)
omniroute config opencode \
--base-url http://localhost:20128 \
--api-key "$OMNIROUTE_API_KEY"
A bayan fage, CLI yana kiran mergeOpenCodeConfigText() (src/shared/services/opencodeConfig.ts:104), don haka opencode.json da ya riga ya kasance zai riƙe sauran masu samar da sabis da sharhinsa. Ana ƙara ko maye gurbin shigarwar OmniRoute ta hanya mai atomic.
Fayil ɗin da aka samar (tsohon kundin samfura):
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"omniroute": {
"npm": "@ai-sdk/openai-compatible",
"name": "OmniRoute",
"options": {
"baseURL": "http://localhost:20128/v1",
"apiKey": "<your-key>",
},
"models": {
"claude-opus-4-5-thinking": { "name": "claude-opus-4-5-thinking" },
"claude-sonnet-4-5-thinking": { "name": "claude-sonnet-4-5-thinking" },
"gemini-3.1-pro-high": { "name": "gemini-3.1-pro-high" },
"gemini-3-flash": { "name": "gemini-3-flash" },
},
},
},
}
Hanya ta 2 — Kunshin npm @omniroute/opencode-provider
An ba da shawarar wannan idan kana sarrafa daidaitawar ta Node/TS (bututun CI, monorepos, hanyoyin mai-shigarwa na musamman).
npm install --save-dev @omniroute/opencode-provider
import { writeFileSync } from "node:fs";
import { buildOmniRouteOpenCodeConfig } from "@omniroute/opencode-provider";
const config = buildOmniRouteOpenCodeConfig({
baseURL: "http://localhost:20128",
apiKey: process.env.OMNIROUTE_API_KEY ?? "sk_omniroute",
// Na zaɓi: sauya kundin samfuran da ake nuna wa OpenCode
models: ["auto", "claude-opus-4-7", "gpt-5.5"],
modelLabels: { auto: "Auto-Combo" },
});
writeFileSync("opencode.json", JSON.stringify(config, null, 2));
Don haɗawa ba tare da lalata fayil ɗin da yake akwai ba, sake aiwatar da mergeOpenCodeConfigText() daga opencodeConfig.ts ko kuma kira mai samarwa na CLI.
Duba README na kunshin don cikakken API.
Abin da runtime yake yi a zahiri
Duk hanyoyin biyu suna samar da provider.omniroute.npm: "@ai-sdk/openai-compatible" iri ɗaya. A lokacin aiki, OpenCode yana loda @ai-sdk/openai-compatible (wanda tuni yake dogaro na kaikaice na OpenCode) kuma yana daidaita shi da baseURL + apiKey. Daga nan:
Fuskar OpenCode/wakili
→ @ai-sdk/openai-compatible
→ HTTP POST {baseURL}/chat/completions (Fuskar OmniRoute ta OpenAI)
→ Mai sarrafa OmniRoute /v1/chat/completions (open-sse/handlers/chatCore.ts)
→ turawar combo / Auto-Combo / executor
→ mai samar da sabis na sama
Plugin ɗin ba ya hulɗa da HTTP ko kaɗan. Yana samar da daidaitawa ne kawai.
Tsoffin katalogin samfura
export const OMNIROUTE_DEFAULT_OPENCODE_MODELS = [
"claude-opus-4-5-thinking",
"claude-sonnet-4-5-thinking",
"gemini-3.1-pro-high",
"gemini-3-flash",
] as const;
Za ka iya sauya su ta hanyar models: [...]. Ƙarin da ake ba da shawara:
"auto"— yana bayyana na'ura mai ba da hanya ta Auto-Combo ta OmniRoute wadda ba ta buƙatar saiti. Yana ba OpenCode damar zaɓar "mafi kyawun samfurin da ake da shi" ba tare da ka ƙayyade katalogin kai tsaye a lamba ba."<combo-name>"— duk wani combo da ka ayyana a dashboard; OmniRoute yana warware shi ba tare da wani ƙarin aiki daga gare ka ba.
Daidaita URL
Kayan taimakon yana karɓar duka nau'ikan kuma yana fitar da /v1 guda ɗaya tak:
| Shigarwa | Fitarwa (options.baseURL) |
|---|---|
http://localhost:20128 |
http://localhost:20128/v1 |
http://localhost:20128/ |
http://localhost:20128/v1 |
http://localhost:20128/v1 |
http://localhost:20128/v1 |
http://localhost:20128/v1/// |
http://localhost:20128/v1 |
Wannan cire maimaitawar ita ce matsalar da aka fi gani a tsofaffin saituna. Idan kana da opencode.json daga sigar da ta gabaci v3.8.0 wanda ke nuni zuwa /v1/v1/..., sake gudanar da na'urar ƙirƙirawa ko kuma sake kiran createOmniRouteProvider.
Hanyoyin tantancewa
| Saitin OmniRoute | Ƙimar apiKey da ake ba da shawara |
|---|---|
REQUIRE_API_KEY=false (tsoho don na gida) |
sk_omniroute (madadin rubutu na zahiri) |
REQUIRE_API_KEY=true |
Maɓallin API na ainihi na kowane mai amfani daga Dashboard → API Keys. |
Ga clients masu salon Anthropic waɗanda ke aika x-api-key + anthropic-version, extractApiKey na OmniRoute yana kuma karɓar maɓallin daga x-api-key. OpenCode yana amfani da fuskar OpenAI, saboda haka koyaushe zai aika Authorization: Bearer ${apiKey} — babu wani keɓantaccen yanayin Anthropic da ya shafi wannan.
Warware matsaloli
| Alama | Dalili | Gyara |
|---|---|---|
404 kan kowace buƙata mai URL ɗauke da /v1/v1/ |
Tsohon saiti daga plugin na kafin v3.8 wanda ya ninka ƙarin /v1. |
Sake ƙirƙira ta Hanya ta 1 ko ta 2. |
401 Invalid API key |
OmniRoute yana da REQUIRE_API_KEY=true kuma ba a san maɓallin ba. |
Ƙirƙiri maɓallin a dashboard, ko saita REQUIRE_API_KEY=false (na gida kawai) sannan ka yi amfani da sk_omniroute. |
| Jerin samfura babu komai a UI na OpenCode | An ɓoye duk tsoffin samfura 4 a ganuwar provider ta OmniRoute. | Wuce models: ["auto", ...] don bayyana waɗanda ka kunna. |
OpenCode 500 tare da cannot read property 'models' |
Tsohon OpenCode (< 0.1.x) bai karɓi models na cikin layi ba. |
Sabunta OpenCode zuwa sigar da ke bin tsarin v1 (opencode.ai/config.json). |
Duba kuma
- Manazartar API — cikakken tsarin OmniRoute REST
- Auto-Combo — abin da
model: "auto"ke nufi @omniroute/opencode-providerREADME- Tushen lamba:
src/shared/services/opencodeConfig.ts,src/lib/cli-helper/config-generator/opencode.ts,@omniroute/opencode-provider/src/index.ts