Usar Apexnova AI Hub con n8n

La credencial de OpenAI de n8n admite una Base URL personalizada. Apúntala a la base compatible con OpenAI de la plataforma y nodos como OpenAI Chat Model o Embeddings OpenAI usarán los modelos de aquí. Los endpoints sin nodo propio se llaman directamente desde un nodo HTTP Request.

Todos los endpoints están en la referencia de la API. La configuración es idéntica en n8n Cloud y autoalojado.

Antes de empezar

• Una instancia de n8n operativa, en la nube o autoalojada.
• Una API key creada en API Keys dentro de la consola. El valor sk- completo solo se muestra una vez, guárdalo en ese momento.
• Comprueba que el modelo que quieres está publicado en el catálogo de modelos y anota su Public Model Name.

1. Comprueba primero la clave y la base URL

Lista los modelos antes de montar nada. De paso te da los nombres de modelo: esos ids son los que piden los nodos.

# Check the key and base URL before wiring anything up in n8n.
# Every id in the response is a name you can type into a node.
curl https://api.apexnova-consulting.com/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxx"

Si este paso falla, el problema está en la clave o en la base URL y n8n todavía no interviene.

2. Crear la credencial de OpenAI

Crea una credencial nueva de OpenAI en n8n (Credentials → New → OpenAI) y rellénala así:

Una vez guardada, cualquier nodo que use una credencial de OpenAI puede usar esta base URL. Si además usas OpenAI directamente, crea una segunda credencial con otro nombre en lugar de editar la original.

3. Elegir modelo en el nodo

Los nodos que más vas a usar y los endpoints que hay detrás:

• OpenAI Chat Model (subnodo de AI Agent o Basic LLM Chain) → /v1/chat/completions, para chat y agentes.
• Embeddings OpenAI (subnodo de los almacenes vectoriales) → /v1/embeddings, para indexar en RAG.
• Nodo OpenAI, Image → Generate an Image → /v1/images/generations.

El desplegable de modelos se carga desde /v1/models, así que con una base URL personalizada lista lo que esa clave puede usar en la plataforma. Si sale vacío o falta el modelo que quieres, cambia el parámetro a modo By ID / expresión y escribe el Public Model Name. Además, deja «Use Responses API» desactivado en el nodo OpenAI Chat Model: el endpoint Responses de la plataforma es siempre sin estado y la opción Conversation ID que activa ese interruptor no está soportada.

4. Todo lo demás, con un nodo HTTP Request

Los endpoints sin nodo integrado — generación de vídeo, Responses — se llaman directamente desde un nodo HTTP Request. Por ejemplo, generación de vídeo:

Method:            POST
URL:               https://api.apexnova-consulting.com/v1/media/videos
Authentication:    Generic Credential Type -> Header Auth
                     Name:  Authorization
                     Value: Bearer sk-xxxxxxxx
Send Body:         on
Body Content Type: JSON

{
  "model": "seedance-1.0-pro",
  "prompt": "Aerial drone shot of a sunrise over the sea",
  "resolution": "720P",
  "ratio": "16:9",
  "duration": 5
}

El vídeo es un trabajo asíncrono: esta llamada devuelve un id y un segundo nodo HTTP Request consulta GET /v1/media/videos/{id} hasta obtener el resultado. La credencial Header Auth vale para todos los endpoints de la plataforma. Cuidado con los reintentos del nodo en endpoints con precio por unidad: cada reintento es una llamada facturable real.

Diagnóstico

• El nodo devuelve 401 —— Clave incorrecta, o el nodo sigue apuntando a otra credencial. Revisa el selector de credencial del nodo.
• El desplegable de modelos está vacío —— Cambia el parámetro de modelo a modo By ID / expresión y escribe el Public Model Name. Comprueba también que la Base URL de la credencial termina en /v1.
• 404 model_not_found —— El nombre no es un Public Model Name de la plataforma, o el modelo queda fuera de la lista blanca del espacio de trabajo de esa clave, o es un modelo privado sin autorizar.
• 429 —— Un tope de presupuesto o un límite de RPM/TPM. Los bucles de automatización son lo que más los toca: sube los límites del espacio de trabajo o añade throttling al flujo.
• Fallan las operaciones de Assistants o Files —— La plataforma implementa chat, embeddings, imagen, vídeo y Responses. Las operaciones del nodo OpenAI que dependen de Assistants o Files no están disponibles.

Buenas prácticas

• Dale a n8n su propia clave dentro de su propio espacio de trabajo y con tope de presupuesto: los bucles de automatización son la forma más fácil de perder el control del gasto.
• En flujos de producción guarda el nombre del modelo en una variable o en el entorno en vez de repetirlo por los nodos, para que cambiar de modelo sea una sola edición.
• Configura una cadena de conmutación por error en «Fallback de modelos» para que un fallo del proveedor no rompa el flujo. La facturación sigue al modelo que realmente respondió.