BroadRouter

BroadNet Inference en n8n (credencial de OpenAI y Base URL)

Actualizado

En n8n, cree una credencial de OpenAI con su clave de BroadNet en API Key y Base URL en https://inference.broadnet.ai/v1. En el nodo OpenAI Chat Model, cambie Model de From List a ID, ingrese un ID de BroadNet como broadnet/glm-5.3 y desactive Use Responses API para que n8n llame a chat completions.

n8n es una herramienta de automatización de flujos de trabajo. Su credencial de OpenAI tiene un campo Base URL, así que el nodo OpenAI Chat Model (y los demás nodos de OpenAI que usan esa credencial) puede llamar a cualquier API compatible con OpenAI. BroadNet Inference es una de ellas. La página de documentación de n8n sobre la credencial no muestra el campo Base URL, por eso los nombres de campos de abajo también se verificaron en el código fuente de n8n, enlazado en las fuentes.

Configuración

  1. Cree la credencial. En n8n, vaya a Credentials, cree una nueva credencial de OpenAI y complete:

    Campo Valor
    API Key su clave de BroadNet
    Organization ID (opcional) déjelo en blanco
    Base URL https://inference.broadnet.ai/v1

    Guárdela. n8n prueba la credencial llamando a /models en la Base URL.

  2. Agregue el nodo del modelo. Agregue un nodo AI Agent o Basic LLM Chain, conecte un subnodo OpenAI Chat Model y seleccione la credencial.

  3. Defina el modelo por ID. En Model, cambie el modo de From List a ID e ingrese broadnet/glm-5.3.

  4. Desactive Use Responses API. En el código fuente de n8n, esta opción existe desde la versión 1.3 del nodo y allí viene activada de forma predeterminada. BroadNet sirve chat completions, así que desactívela.

  5. Configure las opciones. En Options, deje Maximum Number of Tokens en su valor predeterminado (-1) o póngalo en unos pocos miles. Max Retries es 2 de forma predeterminada; auméntelo si quiere que n8n reintente más veces las llamadas fallidas.

  6. Ejecute el flujo de trabajo una vez con un prompt de prueba.

n8n muestra un aviso cuando usa una Base URL que no es de OpenAI: es posible que no todos los modelos sean compatibles con chat ni admitan llamadas a herramientas o el formato de respuesta JSON. En BroadNet, el chat funciona en todos los modelos de chat, pero la documentación de BroadNet indica herramientas y salida estructurada solo para GLM 5.3 y Qwen3.8 27B.

Qué modelo elegir

Flujo de trabajo Modelo Por qué
AI Agent con herramientas broadnet/glm-5.3 BroadNet indica herramientas y salida estructurada
Imágenes, mensajes en árabe broadnet/qwen3.8-27b Herramientas, entrada de imágenes, probado en árabe
Clasificación de alto volumen broadnet/gemma-4-26b-a4b Precio por token bajo; sin razonamiento indicado
Documentos largos broadnet/deepseek-v4.1-flash Contexto de 1M; herramientas no indicadas

Compare precios en la página de precios. Para audio, el nodo HTTP Request de n8n puede enviar archivos a /v1/audio/transcriptions; la guía de voz a texto en árabe muestra los campos del formulario que debe enviar.

Solución de problemas

  • Falla la prueba de la credencial. Verifique que la Base URL termine en /v1 sin ninguna ruta adicional. Si las llamadas de chat también devuelven 401, la clave es incorrecta, venció o se quedó sin saldo de pago por uso.
  • Errores del modelo. Use el modo ID e ingrese el ID exacto de BroadNet con el prefijo broadnet/. GLM 5.3, Qwen3.8 27B y DeepSeek V4.1 Flash requieren una recarga; el crédito inicial de $5 cubre BroadNet Gemma 4 VL 26B.
  • “Bad request - please check your parameters”. La documentación de n8n sugiere repetir la llamada en un nodo HTTP Request para ver el error completo. Una causa común aquí es la opción de Responses API.
  • Salida vacía. El razonamiento cuenta para Maximum Number of Tokens. Auméntelo. Por qué las respuestas llegan vacías.
  • 429 en bucles. Una clave de pago por uso permite 30 solicitudes por minuto y 4 a la vez. La documentación de n8n sugiere Loop Over Items con un nodo Wait para espaciar los lotes. Consulte errores y reintentos.
  • Ejecuciones en paralelo con una clave de plan. Una sesión de plan ilimitado ejecuta una solicitud a la vez. Las ejecuciones paralelas del flujo quedan en cola, salvo que cada una tenga su propia sesión.

¿Prefiere código? La misma configuración funciona en LangChain, sobre el que están construidos los nodos de IA de n8n.

Preguntas frecuentes

¿Por qué falla el AI Agent de n8n con BroadNet?

Verifique que Use Responses API esté desactivado en el nodo OpenAI Chat Model. En la versión 1.3 del nodo viene activado de forma predeterminada, y BroadNet sirve /v1/chat/completions, no la Responses API. Además, ponga Model en modo ID con el ID exacto de BroadNet.

¿Por qué la lista de modelos aparece vacía o incorrecta?

El modo From List lee el endpoint /models del proveedor. La documentación de BroadNet describe ese endpoint como metadatos públicos del catálogo para monitores. Cambie Model al modo ID y escriba el ID del modelo de BroadNet.

¿Por qué el agente de n8n devuelve una salida vacía?

El razonamiento agotó Maximum Number of Tokens. Auméntelo o déjelo en su valor predeterminado de -1.

¿Dónde está el campo Base URL en la credencial de OpenAI de n8n?

Está en la propia credencial de OpenAI, debajo de API Key y Organization ID. Su valor predeterminado es https://api.openai.com/v1. Reemplácelo por https://inference.broadnet.ai/v1, conservando /v1 y sin agregar otra ruta.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity