---
title: "Setup ng opencode custom OpenAI-compatible provider | BroadRouter"
description: "Idagdag ang BroadNet Inference sa opencode coding agent bilang custom OpenAI-compatible provider sa opencode.jsonc, na may model alias, capabilities at limit."
url: https://broadrouter.com/fil/guides/opencode-custom-provider/
lang: fil
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Isinalin mula sa Ingles sa tulong ng AI. [Basahin ang orihinal sa Ingles](https://broadrouter.com/guides/opencode-custom-provider/) (na-update noong 2026-11-16).

# Idagdag ang BroadNet Inference sa opencode bilang custom provider

Na-update 2026-11-16

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:

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Gawin ang config.** Ilagay ito sa project mo bilang `opencode.jsonc`, o sa `~/.config/opencode/opencode.jsonc` para magamit kahit saan.

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

3.  **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:

```json
{
  "$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](https://opencode.ai/docs/migrate-v1/) ang bawat field.

## Aling model ang pipiliin

| Gawain | Model | Mga tala |
| --- | --- | --- |
| Agent coding na may tools | [GLM 5.3](https://broadrouter.com/fil/models/glm-5.3/) | Nakalista ang tools at structured output; 1M context |
| Mga screenshot, Arabic | [Qwen3.8 27B](https://broadrouter.com/fil/models/qwen3.8-27b/) | Tools at mga larawan; 262K context |
| Buong-araw na session, flat na presyo | [DeepSeek V4.1 Flash](https://broadrouter.com/fil/models/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](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/).
-   **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](https://broadrouter.com/fil/guides/errors-and-retries/).
-   **Mga subagent sa isang plan.** Isang request lang sa isang pagkakataon ang hinahawakan ng bawat [plan session](https://broadrouter.com/fil/guides/unlimited-llm-api-sessions/), kaya pipila ang mga parallel na subagent maliban kung may kanya-kanya silang session.

## Mga termino sa gabay na ito

[API key](https://broadrouter.com/fil/glossary/api-key/)

Ang API key ay isang lihim na string na kumikilala at nagpapahintulot sa client na tumatawag sa isang API. Kadalasang hinihingi ito ng mga LLM API sa Authorization: Bearer header, at ang sinumang may hawak ng key ay makakagawa ng mga request na sisingilin sa account na may-ari nito.

[Tool calling (function calling)](https://broadrouter.com/fil/glossary/tool-calling/)

Ang tool calling, tinatawag ding function calling, ay feature ng LLM API kung saan nagbabalik ang model ng structured na request para magpatakbo ng function na tinukoy ng developer, kasama ang JSON arguments. Ang application ang nagpapatakbo ng function at nagpapadala pabalik ng resulta; hindi kailanman nagpapatakbo ng code ang model mismo.

[Pay-as-you-go](https://broadrouter.com/fil/glossary/pay-as-you-go/)

Ang pay-as-you-go ay paraan ng pagpepresyo kung saan ang nagamit mo lang ang binabayaran mo, sinusukat kada yunit gaya ng token, request o minuto ng audio, nang walang subscription o minimum na commitment. Ganito naniningil ang karamihan ng LLM API, mula sa prepaid na balance o sa pana-panahong invoice.

[Context window](https://broadrouter.com/fil/glossary/context-window/)

Ang context window ay ang pinakamaraming token na kayang hawakan ng isang language model sa iisang request. Sakop nito ang prompt, history ng usapan, tool definitions, mga larawan at ang nabuong output, kasama ang anumang reasoning tokens. Ang hindi kasya ay kailangang bawasan, ibuod o hatiin sa ilang request.

[AI agent](https://broadrouter.com/fil/glossary/agent/)

Ang AI agent ay isang system kung saan ang language model mismo ang nagdidirekta ng mga hakbang nito tungo sa isang layunin: pinipili nito kung aling tools ang tatawagin, binabasa ang mga resulta at umuulit hanggang makabuo ng huling sagot o maabot ang limit. Workflow naman ang karaniwang tawag sa fixed na script na tumatawag sa model sa takdang punto.

[Subagent](https://broadrouter.com/fil/glossary/subagent/)

Ang subagent ay hiwalay na agent na sinisimulan ng isang main agent para hawakan ang isang nakatutok na task. Tumatakbo ito nang may sariling context window, system prompt at access sa tools, ginagawa ang trabaho, at resulta o buod lang ang ibinabalik sa main agent, kaya nananatiling maliit ang pangunahing usapan.

[AI coding agent](https://broadrouter.com/fil/glossary/coding-agent/)

Ang AI coding agent ay software tool kung saan gumagana ang isang language model sa codebase nang paulit-ulit sa isang loop: nagbabasa ng mga file, nag-e-edit ng mga ito, nagpapatakbo ng mga command gaya ng tests, binabasa ang output at nagpapasya ng susunod na hakbang hanggang matapos ang task o maabot ang limit.

[Concurrency](https://broadrouter.com/fil/glossary/concurrency/)

Ang concurrency ay ang bilang ng request na sabay-sabay na in flight mula sa isang client. Madalas itong nililimitahan ng mga LLM API kada key o plan, hiwalay sa requests per minute, dahil humahawak ng GPU capacity ang bawat bukas na request hanggang matapos ang response nito.

## 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.

## Mga kaugnay na gabay

-   [Cline sa BroadNet Inference: setup ng OpenAI Compatible provider](https://broadrouter.com/fil/guides/cline-openai-compatible/)
-   [Paano gumagana ang unlimited LLM API plans para sa mga agent](https://broadrouter.com/fil/guides/unlimited-llm-api-sessions/)
-   [Bakit walang laman ang sagot ng isang reasoning model](https://broadrouter.com/fil/guides/reasoning-tokens-empty-response/)
-   [Paano gamitin ang Vercel AI SDK sa BroadNet Inference](https://broadrouter.com/fil/guides/vercel-ai-sdk-openai-compatible/)
-   [Lahat ng tool na gumagana sa BroadNet Inference (Ingles)](https://broadrouter.com/integrations/): mga SDK, coding agent, chat UI at automation tool, kasama ang eksaktong setting ng bawat isa

Subukan ito sa totoong workload mo. May US$5 na panimulang credit ang mga bagong account para sa Gemma at transcription. Kailangan ng top-up para sa DeepSeek, GLM, at Qwen3.8.

[Magsimula](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-opencode-custom-provider&utm_content=page-cta) ·

**Mga source**

-   [opencode docs, Providers (custom provider) (sinuri noong 2026-11-14)](https://opencode.ai/docs/providers/)
-   [opencode docs, Models (alias, capabilities, limit) (sinuri noong 2026-11-14)](https://opencode.ai/docs/models/)
-   [opencode docs, Config locations (sinuri noong 2026-11-14)](https://opencode.ai/docs/config/)
-   [opencode docs, Migrate from V1 (sinuri noong 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [API reference ng BroadNet Inference (Ingles)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fil-guides-opencode-custom-provider&utm_content=sources)
