BroadRouter
Comenzar

Usar Zed con BroadNet Inference como proveedor compatible con OpenAI

Actualizado

En el settings.json de Zed, agregue un proveedor bajo language_models.openai_compatible, por ejemplo broadnet, con api_url en https://inference.broadnet.ai/v1 y available_models con IDs de BroadNet como broadnet/glm-5.3, con max_tokens igual al tamaño del contexto. Zed lee la clave de BROADNET_API_KEY, o puede guardarla en Agent Settings.

Zed es un editor de código abierto con un agente integrado. Se conecta a cualquier servidor con una API compatible con OpenAI mediante su tipo de proveedor openai_compatible. BroadNet Inference sirve chat completions estándar en https://inference.broadnet.ai/v1, así que encaja. BroadRouter es el sitio de la propia BroadNet; los pasos de abajo siguen la documentación de acceso por API de Zed tal como está en Zed 1.28.

Configuración

  1. Obtenga una clave. Cree una clave de pago por uso en la consola de BroadNet o use la clave de un plan ilimitado.
  2. Agregue el proveedor. Abra Agent Settings con el comando agent: open settings y haga clic en Add Provider en la sección LLM Providers, o edite settings.json directamente:
{
  "language_models": {
    "openai_compatible": {
      "broadnet": {
        "api_url": "https://inference.broadnet.ai/v1",
        "available_models": [
          {
            "name": "broadnet/glm-5.3",
            "display_name": "GLM 5.3 (BroadNet)",
            "max_tokens": 1048576,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          },
          {
            "name": "broadnet/qwen3.8-27b",
            "display_name": "Qwen3.8 27B (BroadNet)",
            "max_tokens": 262144,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          }
        ]
      }
    }
  }
}
  1. Dele la clave a Zed. Expórtela antes de iniciar Zed, o péguela en el proveedor dentro de Agent Settings. Zed guarda las claves pegadas en el llavero del sistema (keychain), no en settings.json.
export BROADNET_API_KEY='your-broadnet-key'
  1. Pruébelo. Abra el Agent Panel, elija GLM 5.3 (BroadNet) en el selector de modelos y haga una pregunta breve sobre un archivo abierto. Si recibe una respuesta, la conexión funciona.

Qué significa cada ajuste

  • name es el ID de modelo que envía Zed. Use el ID de BroadNet exactamente, con el prefijo broadnet/.
  • max_tokens es la ventana de contexto en el esquema de Zed, no el límite de salida. Use 1,048,576 para GLM 5.3 y DeepSeek V4.1 Flash, y 262,144 para Qwen3.8 27B.
  • max_output_tokens limita la respuesta. El 16,000 de arriba es nuestra sugerencia, no un límite de BroadNet. El razonamiento cuenta dentro de este valor, así que no lo ponga bajo.
  • max_tokens_parameter: true hace que Zed envíe el límite de salida como max_tokens en lugar de max_completion_tokens. La referencia de la API de BroadNet describe el campo max_tokens.
  • images es false por defecto en los modelos compatibles con OpenAI. Actívelo solo en modelos que aceptan imágenes: Qwen3.8 27B, DeepSeek V4.1 Flash y BroadNet Gemma 4 VL 26B.
  • reasoning_effort es opcional. La documentación de BroadNet sugiere low si quiere un razonamiento más corto.

Qué modelo elegir

Uso Modelo Por qué
Ediciones del agente con herramientas broadnet/glm-5.3 BroadNet lo lista con herramientas y salida estructurada; contexto de 1M
Capturas de pantalla y texto en árabe broadnet/qwen3.8-27b Herramientas y entrada de imágenes; contexto de 262K
Chats largos con un plan de tarifa plana broadnet/deepseek-v4.1-flash El modelo del plan ilimitado; entrada de imágenes; BroadNet no lo lista con herramientas

Zed asume tools: true en los modelos compatibles con OpenAI. La documentación de BroadNet no incluye llamadas a herramientas (tool calling) para DeepSeek V4.1 Flash, así que pruebe una tarea real del agente con él antes de depender de ello. Una hora de Meteoro (Meteor) ($1) es una forma económica de probarlo antes de un mes de Luna Llena (Full Moon) ($60).

Solución de problemas

  • 401. La clave es incorrecta, caducó o se quedó sin saldo. Si definió BROADNET_API_KEY, tiene prioridad sobre el llavero; elimínela y reinicie Zed para usar la clave guardada.
  • 404 en todas las solicitudes. Compruebe que api_url termine en /v1. Luego compruebe que name coincida exactamente con el ID de BroadNet. 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. El modelo gastó su presupuesto de salida en razonar. Suba max_output_tokens o defina reasoning_effort como low. Por qué las respuestas llegan vacías.
  • 429. Una clave de pago por uso permite 30 solicitudes por minuto y 4 en curso. Una sesión de plan ejecuta una solicitud a la vez. Consulte errores y reintentos.
  • Proyectos remotos. Zed inicializa los proveedores en la app local, así que por SSH la clave viene de su llavero local o de su entorno local, no de la máquina remota.

Preguntas frecuentes

¿Qué variable de entorno lee Zed para la clave de un proveedor personalizado?

Zed construye el nombre a partir del ID del proveedor en upper snake case más _API_KEY. Un proveedor llamado broadnet lee BROADNET_API_KEY. Si la variable no está vacía, tiene prioridad sobre una clave guardada en el llavero (keychain).

¿El modelo de BroadNet funciona en el Agent Panel de Zed?

Sí. El acceso por API de Zed cubre el Zed Agent, el Inline Assistant, los mensajes de commit y los resúmenes de hilos. Zed asume soporte de herramientas en los modelos compatibles con OpenAI, así que elija GLM 5.3 o Qwen3.8 27B, que BroadNet lista con herramientas.

¿Esto cambia las edit predictions de Zed?

No. La documentación de Zed indica que edit prediction tiene su propia configuración de proveedor bajo edit_predictions. El proveedor de esta guía es para el agente y las demás funciones de IA de Zed.

¿Por qué Zed dice que el modelo solo funciona con la Responses API?

No debería pasar con BroadNet. Deje capabilities.chat_completions en su valor predeterminado, true. BroadNet sirve /v1/chat/completions y no incluye la Responses API.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity