BroadRouter
Comenzar

Agregue BroadNet Inference a opencode como proveedor personalizado

Actualizado

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:
export BROADNET_API_KEY='your-broadnet-key'
  1. Cree la configuración. Póngala en su proyecto como opencode.jsonc, o en ~/.config/opencode/opencode.jsonc para usarla en todas partes.
{
  "$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. 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:

{
  "$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 relaciona cada campo.

Qué modelo elegir

Tarea Modelo Notas
Programación con agentes y herramientas GLM 5.3 Herramientas y salida estructurada indicadas; contexto de 1M
Capturas de pantalla, árabe Qwen3.8 27B Herramientas e imágenes; contexto de 262K
Sesiones de todo el día, precio fijo 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.
  • 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.
  • Subagentes con un plan. Cada sesión de plan atiende una solicitud a la vez, así que los subagentes en paralelo quedan en cola salvo que cada uno tenga su propia sesión.

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.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity