BroadRouter
Magsimula

Idagdag ang BroadNet Inference sa opencode bilang custom provider

Na-update

Sa opencode.jsonc, magdagdag ng broadnet entry sa ilalim ng providers na may package na @opencode/ai/providers/openai-compatible, settings.baseURL na https://inference.broadnet.ai/v1 at env na BROADNET_API_KEY. I-map ang maiikling model key sa mga BroadNet ID gamit ang modelID, gaya ng broadnet/glm-5.3, saka piliin ang model gamit ang /models. Gumagana pa rin ang mas lumang V1 config na may npm @ai-sdk/openai-compatible at options.baseURL.

Ang opencode ay open-source na coding agent para sa terminal. Ang mga provider na wala sa built-in catalog nito ay idinadagdag bilang custom provider sa opencode.jsonc. OpenAI chat-completions format ang gamit ng BroadNet Inference, kaya ang OpenAI-compatible runtime package ng opencode ang ginagamit nito. Sinusundan ng gabay na ito ang kasalukuyang (V2) docs ng opencode.

Setup

  1. I-export ang key mo sa shell na nagpapatakbo ng opencode:
export BROADNET_API_KEY='your-broadnet-key'
  1. Gawin ang config. Ilagay ito sa project mo bilang opencode.jsonc, o sa ~/.config/opencode/opencode.jsonc para magamit kahit saan.
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
  1. Simulan ang opencode at piliin ang model gamit ang /models. Ang reference ay broadnet/<map key>, halimbawa broadnet/glm-5.3. Ang value ng modelID ang ipinapadala ng opencode sa BroadNet.

Pinagsasama ang mga config file. Inuuna ng opencode ang global file, saka ang mga project file na nakikita mula sa kasalukuyang directory paakyat (inuuna ang pinakamalayo), saka ang anumang .opencode/ config, kaya puwedeng palitan ng project file ang global na provider. Kung gumagamit ang kumpanya mo ng managed system config, ito ang nangingibabaw sa dalawa. Itago ang key sa environment, hindi sa file, para puwedeng isama ang config sa version control.

Bakit may mga alias

May slash na ang mga BroadNet ID (broadnet/glm-5.3). Ang key ng models map ang ipinapakita at pinipili ng opencode, at ang modelID ang ipinapadala nito. Pinapanatiling madaling basahin ng maiikling key ang mga reference.

Ikaw mismo ang mag-set ng capabilities at limit. Para sa model na wala sa catalog nito, ipinapalagay ng opencode na may JSON tool support, text at image input, 200,000-token na context at 32,000 output token. Tinatawag ito ng docs nito na fallback assumptions, hindi mga value na na-detect. Ang output na 16000 sa itaas ay mungkahi namin, hindi limit ng BroadNet; nag-iiwan ito ng puwang para sa reasoning.

Mas lumang V1 config

Binabasa pa rin ng opencode V2 ang V1 format, kaya patuloy na gagana ang isang umiiral na block na ganito:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}

Sa native na V2 form, nagiging providers ang provider, nagiging package ang npm (aisdk:@ai-sdk/openai-compatible kung gusto mong panatilihin ang AI SDK package), at lumilipat ang options.baseURL at options.apiKey sa ilalim ng settings. Inima-map ng V1 migration guide ng opencode ang bawat field.

Aling model ang pipiliin

Gawain Model Mga tala
Agent coding na may tools GLM 5.3 Nakalista ang tools at structured output; 1M context
Mga screenshot, Arabic Qwen3.8 27B Tools at mga larawan; 262K context
Buong-araw na session, flat na presyo DeepSeek V4.1 Flash Mga unlimited na plan; walang tools na nakalista sa BroadNet

Umaasa ang opencode sa mga tool call. Hindi nakalista sa docs ng BroadNet ang tool calling para sa DeepSeek V4.1 Flash, kaya minamarkahan ito ng config bilang assumption na dapat subukan. Magpatakbo ng totoong task sa isang Meteor hour ($1) bago bumili ng isang buwang Full Moon ($60).

Troubleshooting

  • 401. Mali, expired, o ubos na ang pay-as-you-go allowance ng key sa BROADNET_API_KEY. Tiyaking naka-set ang variable sa process na nagpapatakbo ng opencode.
  • Hindi mahanap o tinanggihan ang model. Piliin ang map key (broadnet/glm-5.3), at tiyaking eksaktong tugma ang modelID sa ID ng BroadNet. Case-sensitive ang mga reference. Kailangan ng top-up para sa mga bayad na model; ang broadnet/gemma-4-26b-a4b at ang dalawang Transcribe model lang ang sakop ng $5 na credit.
  • Walang laman na sagot. Taasan ang limit.output. Bakit walang laman ang mga sagot.
  • 429. Ang mga pay-as-you-go key ay may 30 request kada minuto at 4 na sabay-sabay. Kasama rin ang mga retry. Tingnan ang errors and retries.
  • Mga subagent sa isang plan. Isang request lang sa isang pagkakataon ang hinahawakan ng bawat plan session, kaya pipila ang mga parallel na subagent maliban kung may kanya-kanya silang session.

Mga tanong

Bakit hindi mahanap ng opencode ang BroadNet model ko?

Binabasa ng opencode ang reference bilang provider/map key, at case-sensitive ang mga ID. Sa config sa ibaba, piliin ang broadnet/glm-5.3, kung saan glm-5.3 ang map key. Ang value ng modelID ay ang ipinapadala lang sa BroadNet.

May provider at npm na @ai-sdk/openai-compatible ang config ko. Mali ba iyon?

Hindi. V1 format iyon, at sinasabi ng migration guide ng opencode na suportado pa rin ito. Sa native na V2 form, nagiging providers ang provider, package (aisdk:@ai-sdk/openai-compatible) ang npm, at settings.baseURL ang options.baseURL.

Bakit walang laman ang mga sagot ng opencode?

Naubos ng model ang output budget nito sa reasoning. Taasan ang limit.output para sa model. Sa BroadNet, kasama ang reasoning sa max_tokens.

Basahin bilang MarkdownTanungin ang ChatGPTTanungin ang ClaudeTanungin ang Perplexity