OmniRoute/docs/i18n/gu/docs/frameworks/OPENCODE.md

OpenCode Integration (ગુજરાતી)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇳🇬 ha · 🇮🇱 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

---

સ્થિતિ: સામાન્ય રીતે ઉપલબ્ધ. લક્ષિત વપરાશકર્તાઓ: OpenCodeને OmniRoute ડિપ્લોયમેન્ટ સાથે જોડતા ઑપરેટર્સ. અધિકૃત સ્રોત (કૉન્ફિગ સ્કીમા): src/shared/services/opencodeConfig.ts અધિકૃત સ્રોત (npm પૅકેજ): @omniroute/opencode-provider/ (પ્રકાશિત કરી શકાય તેવું વર્કસ્પેસ)

OpenCode એક એજન્ટિક CLI/ડેસ્કટૉપ AI ક્લાયન્ટ છે. તે તેનું પ્રોવાઇડર કૅટલૉગ ~/.config/opencode/opencode.json (અથવા opencode.jsonc)માંથી વાંચે છે અને https://opencode.ai/config.json પરના સ્કીમાને અનુસરે છે. OmniRoute પોતાને OpenCode સમક્ષ આવા પ્રોવાઇડર્સમાંથી એક તરીકે રજૂ કરે છે — દરેક વિનંતી OmniRouteના પ્રમાણભૂત OpenAI-સુસંગત /v1 ઇન્ટરફેસમાંથી પસાર થાય છે, તેથી OpenCodeને Auto-Combo રાઉટિંગ, સર્કિટ બ્રેકર્સ, કી નીતિઓ, અવલોકનક્ષમતા વગેરેના લાભ આપમેળે મળે છે.

ત્યાં બે સમર્થિત ઇન્ટિગ્રેશન માર્ગો છે. કોઈ એક પસંદ કરો — બંને સમાન કૉન્ફિગ બનાવે છે.

---

માર્ગ 1 — CLI જનરેટર (npm ઇન્સ્ટૉલની જરૂર નથી)

અંતિમ વપરાશકર્તાઓ માટે ભલામણ કરેલ. OmniRoute સાથે જ ઉપલબ્ધ થાય છે. opencode.jsonને તેના સ્થાને લખે છે.

# OmniRoute ઇન્સ્ટૉલ કર્યા પછી (npm i -g @omniroute/cli અથવા સ્થાનિક ક્લોન)
omniroute config opencode \
  --base-url http://localhost:20128 \
  --api-key "$OMNIROUTE_API_KEY"

પડદા પાછળ CLI mergeOpenCodeConfigText() (src/shared/services/opencodeConfig.ts:104)ને કૉલ કરે છે, તેથી હાલની opencode.json ફાઇલ તેના અન્ય પ્રોવાઇડર્સ અને ટિપ્પણીઓ જાળવી રાખે છે. OmniRoute એન્ટ્રી અણુરૂપે ઉમેરવામાં/બદલવામાં આવે છે.

પરિણામી ફાઇલ (ડિફૉલ્ટ મોડલ કૅટલૉગ):

{
  "$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" },
      },
    },
  },
}

---

માર્ગ 2 — npm પૅકેજ @omniroute/opencode-provider

જ્યારે તમે Node/TSમાંથી કૉન્ફિગને સ્ક્રિપ્ટ દ્વારા બનાવી રહ્યા હોવ ત્યારે ભલામણ કરેલ (CI પાઇપલાઇન્સ, મોનોરેપોઝ, કસ્ટમ ઇન્સ્ટૉલર ફ્લોઝ).

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",
  // વૈકલ્પિક: OpenCode સમક્ષ રજૂ થતા મોડલ કૅટલૉગને ઓવરરાઇડ કરો
  models: ["auto", "claude-opus-4-7", "gpt-5.5"],
  modelLabels: { auto: "Auto-Combo" },
});

writeFileSync("opencode.json", JSON.stringify(config, null, 2));

હાલની ફાઇલ સાથે બિન-વિનાશક મર્જ માટે, opencodeConfig.tsમાંથી mergeOpenCodeConfigText()ની નકલ કરો અથવા CLI જનરેટરને કૉલ કરો.

સંપૂર્ણ API માટે પૅકેજ README જુઓ.

---

રનટાઇમ ખરેખર શું કરે છે

બંને માર્ગો સમાન provider.omniroute.npm: "@ai-sdk/openai-compatible" બનાવે છે. રનટાઇમ દરમિયાન, OpenCode @ai-sdk/openai-compatibleને લોડ કરે છે (જે પહેલેથી જ OpenCodeની ટ્રાન્ઝિટિવ ડિપેન્ડન્સી છે) અને તેને baseURL + apiKey વડે કૉન્ફિગર કરે છે. ત્યારબાદ:

OpenCode UI/એજન્ટ
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (OmniRoute OpenAI ઇન્ટરફેસ)
         → OmniRoute /v1/chat/completions હૅન્ડલર     (open-sse/handlers/chatCore.ts)
            → કૉમ્બો રાઉટિંગ / Auto-Combo / એક્ઝિક્યુટર
               → અપસ્ટ્રીમ પ્રોવાઇડર

પ્લગઇન ક્યારેય HTTPને સ્પર્શતું નથી. તે માત્ર કૉન્ફિગ્યુરેશન ઉત્પન્ન કરે છે.

---

મોડેલ કૅટલૉગનાં ડિફૉલ્ટ્સ

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;

તમે models: [...] દ્વારા તેને ઓવરરાઇડ કરી શકો છો. ભલામણ કરેલા ઉમેરાઓ:

• "auto" — OmniRouteનું Auto-Combo શૂન્ય-કૉન્ફિગ રાઉટર ઉપલબ્ધ કરાવે છે. તે OpenCodeને કૅટલૉગમાં હાર્ડ-કોડ કર્યા વિના "શ્રેષ્ઠ ઉપલબ્ધ મોડેલ" પસંદ કરવા દે છે.
• "<combo-name>" — તમે ડૅશબોર્ડમાં વ્યાખ્યાયિત કરેલું કોઈપણ કૉમ્બો; OmniRoute તેને પારદર્શક રીતે ઉકેલે છે.

---

URL નૉર્મલાઇઝેશન

હેલ્પર બંને સ્વરૂપો સ્વીકારે છે અને બરાબર એક /v1 ઉત્પન્ન કરે છે:

ઇનપુટ	આઉટપુટ (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

આ ડિડુપ્લિકેશન જૂના કૉન્ફિગમાં જોવા મળતી સૌથી સામાન્ય ખામી છે. જો તમારી પાસે v3.8.0 પહેલાંનું એવું opencode.json હોય જે /v1/v1/... તરફ નિર્દેશ કરે છે, તો જનરેટર ફરીથી ચલાવો અથવા createOmniRouteProviderને ફરીથી કૉલ કરો.

---

ઑથેન્ટિકેશન મોડ્સ

OmniRoute સેટિંગ	ભલામણ કરેલું apiKey મૂલ્ય
REQUIRE_API_KEY=false (સ્થાનિક માટે ડિફૉલ્ટ)	sk_omniroute (શાબ્દિક પ્લેસહોલ્ડર)
REQUIRE_API_KEY=true	ડૅશબોર્ડ → API Keysમાંથી વાસ્તવિક પ્રતિ-વપરાશકર્તા API કી.

x-api-key + anthropic-version મોકલતા Anthropic-શૈલીના ક્લાયન્ટ્સ માટે, OmniRouteનું extractApiKey x-api-keyમાંથી મળતી કીને પણ માન્ય રાખે છે. OpenCode, OpenAI સપાટીનો ઉપયોગ કરે છે, તેથી તે હંમેશાં Authorization: Bearer ${apiKey} મોકલશે — અહીં Anthropic માટેનો કોઈ ખાસ કિસ્સો લાગુ પડતો નથી.

---

સમસ્યાનિવારણ

લક્ષણ	કારણ	ઉકેલ
/v1/v1/ ધરાવતા URL સાથેની દરેક વિનંતી પર 404	v3.8 પહેલાંના પ્લગઇનનું જૂનું કૉન્ફિગ, જેણે /v1 પ્રત્યય બે વાર ઉમેર્યો હતો.	પાથ 1 અથવા 2 દ્વારા ફરીથી જનરેટ કરો.
401 Invalid API key	OmniRouteમાં REQUIRE_API_KEY=true છે અને કી અજ્ઞાત છે.	ડૅશબોર્ડમાં કી બનાવો અથવા REQUIRE_API_KEY=false (ફક્ત સ્થાનિક માટે) સેટ કરો અને sk_omnirouteનો ઉપયોગ કરો.
OpenCode UIમાં મોડેલ સૂચિ ખાલી છે	OmniRouteની પ્રોવાઇડર વિઝિબિલિટીમાં તમામ 4 ડિફૉલ્ટ મોડેલ છુપાયેલા છે.	તમે સક્ષમ કરેલા મોડેલ દર્શાવવા માટે models: ["auto", ...] પાસ કરો.
cannot read property 'models' સાથે OpenCode 500	જૂના OpenCode (< 0.1.x)માં ઇનલાઇન models સ્વીકારવામાં આવતાં નહોતાં.	v1 સ્કીમા (opencode.ai/config.json) અનુસરતા OpenCodeના સંસ્કરણ પર અપગ્રેડ કરો.

---

આ પણ જુઓ

• API સંદર્ભ — સંપૂર્ણ OmniRoute REST સપાટી
• Auto-Combo — model: "auto" નો અર્થ શું છે
• @omniroute/opencode-provider README
• સ્રોત: src/shared/services/opencodeConfig.ts, src/lib/cli-helper/config-generator/opencode.ts, @omniroute/opencode-provider/src/index.ts