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
- Exporte su clave en la shell desde la que inicia opencode:
export BROADNET_API_KEY='your-broadnet-key'
- Cree la configuración. Póngala en su proyecto como
opencode.jsonc, o en~/.config/opencode/opencode.jsoncpara 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 }
}
}
}
}
}
- Inicie opencode y elija el modelo con
/models. La referencia esbroadnet/<map key>, por ejemplobroadnet/glm-5.3. opencode envía el valor demodelIDa 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_KEYes 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 quemodelIDcoincida 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 solobroadnet/gemma-4-26b-a4by 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.
