---
title: "opencode: proveedor personalizado compatible con OpenAI"
description: "Agregue BroadNet Inference al agente de programación opencode como proveedor personalizado compatible con OpenAI en opencode.jsonc, con alias, capacidades y límites."
url: https://broadrouter.com/es/guides/opencode-custom-provider/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/opencode-custom-provider/) (actualizado el 2026-11-16).

# Agregue BroadNet Inference a opencode como proveedor personalizado

Actualizado 2026-11-16

En opencode.jsonc, agregue una entrada broadnet bajo providers con el package @opencode/ai/providers/openai-compatible, settings.baseURL igual a https://inference.broadnet.ai/v1 y env igual a BROADNET\_API\_KEY. Asigne claves cortas a los IDs de BroadNet con modelID, como broadnet/glm-5.3, y elija el modelo con /models. Las configuraciones V1 antiguas con npm @ai-sdk/openai-compatible y options.baseURL siguen funcionando.

opencode es un agente de programación de código abierto para la terminal. Los proveedores que no están en su catálogo integrado se agregan como **proveedores personalizados** en `opencode.jsonc`. BroadNet Inference habla el formato de chat completions de OpenAI, así que usa el paquete de runtime compatible con OpenAI de opencode. Esta guía sigue la documentación actual (V2) de opencode.

## Configuración

1.  **Exporte su clave** en la shell desde la que inicia opencode:

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

2.  **Cree la configuración.** Póngala en su proyecto como `opencode.jsonc`, o en `~/.config/opencode/opencode.jsonc` para usarla en todas partes.

```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.  **Inicie opencode y elija el modelo** con `/models`. La referencia es `broadnet/<map key>`, por ejemplo `broadnet/glm-5.3`. opencode envía el valor de `modelID` a BroadNet.

Los archivos de configuración se combinan. opencode aplica primero el archivo global, luego los archivos de proyecto que encuentra desde el directorio actual hacia arriba (el más lejano primero) y después cualquier configuración de `.opencode/`, así que un archivo de proyecto puede sobrescribir el proveedor global. La configuración de sistema administrada, si su empresa la usa, tiene prioridad sobre ambos. Guarde la clave en el entorno, no en el archivo, para que la configuración pueda ir al control de versiones.

## Por qué los alias

Los IDs de BroadNet ya contienen una barra (`broadnet/glm-5.3`). La clave del mapa `models` es lo que opencode muestra y selecciona, y `modelID` es lo que envía. Las claves cortas mantienen legibles las referencias.

Defina `capabilities` y `limit` usted mismo. Para un modelo fuera de su catálogo, opencode supone compatibilidad con herramientas JSON, entrada de texto e imagen, un contexto de 200,000 tokens y 32,000 tokens de salida. Su documentación los llama supuestos de respaldo, no valores detectados. El valor `output` de 16000 de arriba es una sugerencia nuestra, no un límite de BroadNet; deja margen para el razonamiento.

### Configuraciones V1 antiguas

opencode V2 sigue leyendo el formato V1, así que un bloque existente como este sigue funcionando:

```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" }
      }
    }
  }
}
```

En la forma nativa V2, `provider` pasa a ser `providers`, `npm` pasa a ser `package` (`aisdk:@ai-sdk/openai-compatible` si quiere conservar el paquete de AI SDK), y `options.baseURL` y `options.apiKey` se mueven a `settings`. La [guía de migración desde V1 de opencode](https://opencode.ai/docs/migrate-v1/) relaciona cada campo.

## Qué modelo elegir

| Tarea | Modelo | Notas |
| --- | --- | --- |
| Programación con agentes y herramientas | [GLM 5.3](https://broadrouter.com/es/models/glm-5.3/) | Herramientas y salida estructurada indicadas; contexto de 1M |
| Capturas de pantalla, árabe | [Qwen3.8 27B](https://broadrouter.com/es/models/qwen3.8-27b/) | Herramientas e imágenes; contexto de 262K |
| Sesiones de todo el día, precio fijo | [DeepSeek V4.1 Flash](https://broadrouter.com/es/models/deepseek-v4.1-flash/) | Planes ilimitados; BroadNet no indica herramientas |

opencode depende de las llamadas a herramientas. La documentación de BroadNet no indica llamadas a herramientas para DeepSeek V4.1 Flash, así que la configuración lo marca como un supuesto que debe probar. Ejecute una tarea real con una hora de Meteoro (Meteor) ($1) antes de comprar un mes de Luna Llena (Full Moon) ($60).

## Solución de problemas

-   **401.** La clave de `BROADNET_API_KEY` es incorrecta, caducó o se quedó sin saldo de pago por uso. Asegúrese de que la variable esté definida en el proceso que ejecuta opencode.
-   **Modelo no encontrado o rechazado.** Seleccione la clave del mapa (`broadnet/glm-5.3`) y compruebe que `modelID` coincida exactamente con el ID de BroadNet. Las referencias distinguen mayúsculas de minúsculas. Los modelos de pago requieren una recarga; el crédito de $5 cubre solo `broadnet/gemma-4-26b-a4b` y los dos modelos Transcribe.
-   **Respuestas vacías.** Aumente `limit.output`. [Por qué las respuestas llegan vacías](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **429.** Las claves de pago por uso permiten 30 solicitudes por minuto y 4 en curso. Los reintentos también cuentan. Consulte [errores y reintentos](https://broadrouter.com/es/guides/errors-and-retries/).
-   **Subagentes con un plan.** Cada [sesión de plan](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/) atiende una solicitud a la vez, así que los subagentes en paralelo quedan en cola salvo que cada uno tenga su propia sesión.

## Términos de esta guía

[Llamadas a herramientas (tool calling)](https://broadrouter.com/es/glossary/tool-calling/)

Las llamadas a herramientas (tool calling), también llamadas function calling, son una función de las APIs de LLM en la que el modelo devuelve una solicitud estructurada para ejecutar una función definida por el desarrollador, con argumentos JSON. La aplicación ejecuta la función y devuelve el resultado; el modelo nunca ejecuta código.

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Token](https://broadrouter.com/es/glossary/token/)

Un token es la unidad de texto que un modelo de lenguaje lee y escribe: una palabra, parte de una palabra, un signo de puntuación o una secuencia de bytes producida por el tokenizador del modelo. Las APIs de LLM cuentan, limitan y normalmente facturan el uso en tokens.

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

[Subagente (subagent)](https://broadrouter.com/es/glossary/subagent/)

Un subagente es un agente independiente que un agente principal inicia para resolver una tarea concreta. Se ejecuta con su propia ventana de contexto, prompt de sistema y acceso a herramientas, hace el trabajo y devuelve al agente principal solo un resultado o resumen, lo que mantiene pequeña la conversación principal.

[Agente de programación con IA (AI coding agent)](https://broadrouter.com/es/glossary/coding-agent/)

Un agente de programación con IA es una herramienta de software en la que un modelo de lenguaje trabaja sobre una base de código en un ciclo: lee archivos, los edita, ejecuta comandos como pruebas, lee la salida y decide el siguiente paso hasta que termina la tarea o alcanza un límite.

[API de Chat Completions](https://broadrouter.com/es/glossary/chat-completions-api/)

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

## Preguntas frecuentes

### ¿Por qué opencode no encuentra mi modelo de BroadNet?

opencode resuelve la referencia como proveedor/clave del mapa, y los IDs distinguen mayúsculas de minúsculas. Con la configuración de abajo, seleccione broadnet/glm-5.3, donde glm-5.3 es la clave del mapa. El valor de modelID es solo lo que se envía a BroadNet.

### Mi configuración usa provider y npm con @ai-sdk/openai-compatible. ¿Está mal?

No. Es el formato V1, y la guía de migración de opencode dice que sigue siendo compatible. La forma nativa V2 cambia provider por providers, npm por package (aisdk:@ai-sdk/openai-compatible) y options.baseURL por settings.baseURL.

### ¿Por qué opencode devuelve respuestas vacías?

El modelo gastó su presupuesto de salida en razonamiento. Aumente limit.output para ese modelo. En BroadNet, el razonamiento cuenta para max\_tokens.

## Guías relacionadas

-   [Cline con BroadNet Inference (proveedor OpenAI Compatible)](https://broadrouter.com/es/guides/cline-openai-compatible/)
-   [Cómo funcionan los planes de API de LLM ilimitada para agentes](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/)
-   [¿Por qué un modelo de razonamiento devuelve una respuesta vacía?](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/)
-   [Cómo usar el Vercel AI SDK con BroadNet Inference](https://broadrouter.com/es/guides/vercel-ai-sdk-openai-compatible/)
-   [Todas las herramientas que funcionan con BroadNet Inference (en inglés)](https://broadrouter.com/integrations/): SDK, agentes de programación, interfaces de chat y herramientas de automatización, con la configuración exacta de cada una

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

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

**Fuentes**

-   [Documentación de opencode, Providers (proveedor personalizado) (consultada el 2026-11-14)](https://opencode.ai/docs/providers/)
-   [Documentación de opencode, Models (alias, capacidades, límites) (consultada el 2026-11-14)](https://opencode.ai/docs/models/)
-   [Documentación de opencode, ubicaciones de la configuración (consultada el 2026-11-14)](https://opencode.ai/docs/config/)
-   [Documentación de opencode, migración desde V1 (consultada el 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [Referencia de la API de BroadNet Inference (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-opencode-custom-provider&utm_content=sources)
