Nodo OpenAI Chat Model n8nConfigura OpenAI Chat Model en n8n.

Determina qué modelo de OpenAI genera la respuesta. n8n carga la lista de forma dinámica desde OpenAI al abrir el desplegable, así que ves exactamente lo que tu cuenta puede llamar.

• Model: un desplegable que se rellena en ejecución desde tu cuenta. Un modelo que esperas y no aparece es una cuestión de acceso, no un fallo del nodo.

Sustituye la dirección de API que se usa por defecto. Vacío, el nodo llama a OpenAI en su dirección habitual; relleno, todas sus peticiones salen hacia la que escribas.

• Base URL: una dirección de endpoint completa, aplicada solo a este nodo y no a los demás nodos de OpenAI del mismo flujo.

Regula cuánto se repite el modelo. Los valores positivos penalizan los tokens según la frecuencia con la que ya aparecen en el texto, lo que baja la probabilidad de ver la misma frase repetida palabra por palabra.

• Frequency Penalty: un número. Cuanto más sube, menos repetición, pero también más se aleja la redacción de lo que pedía el prompt.

Pone techo a lo que vuelve. Un token equivale más o menos a un trozo de palabra, y este campo dice cuántos puede gastar la respuesta.

• Maximum Number of Tokens: un número. La mayoría de modelos tiene una ventana de contexto de 2048 tokens, así que hay que dejar sitio al prompt además de a la respuesta.

Decide si la respuesta llega como texto corriente o como documento JSON. Es la versión sencilla del ajuste, con dos opciones, del lado de Chat Completions.

• Text (text): una respuesta de texto normal, el comportamiento por defecto.
• JSON (json_object): activa el modo JSON, que debería garantizar que el mensaje generado sea JSON válido.

El control de formato más completo, disponible en la vía de la API Responses: aquí describes la forma esperada en lugar de limitarte a pedir JSON.

• Type: text, json_schema, el recomendado, o json_object.
• Name: el nombre del formato. Solo letras, cifras, guiones y guiones bajos, con 64 caracteres como máximo.
• Schema: el propio esquema JSON, con Description para explicarlo y Strict para obligar a que cada respuesta lo cumpla.
• Verbosity: low, medium o high.

Empuja al modelo hacia terreno nuevo. Los valores positivos penalizan los tokens por el simple hecho de haber aparecido ya en el texto, lo que aumenta la probabilidad de que hable de temas nuevos.

• Presence Penalty: un número. Más alto, el discurso se abre; demasiado alto, se aleja de la pregunta.

Fija cuánto azar hay en el muestreo. Al bajarlo las respuestas son menos aleatorias; cerca de cero el modelo se vuelve determinista y repetitivo.

• Sampling Temperature: un número. Más alto diversifica el muestreo, pero aumenta el riesgo de alucinaciones.

Indica cuánta reflexión debe gastar el modelo antes de contestar. Más tokens de razonamiento significa respuesta más completa y petición más lenta.

• Low (low): favorece la velocidad y un uso económico de tokens.
• Medium (medium): equilibrio entre velocidad y precisión del razonamiento.
• High (high): favorece un razonamiento más completo, a costa de generar más tokens y responder más lento.

Fija el tiempo máximo que puede durar una petición, en milisegundos. Pasado ese punto se corta y el nodo devuelve un error en lugar de quedarse colgado.

• Timeout: un número en milisegundos, así que 2000 son dos segundos.

Cuántas veces reintenta el nodo una petición fallida antes de rendirse y hacer fallar la ejecución.

• Max Retries: un número. Cada reintento repite la misma petición, así que un lote grande tarda proporcionalmente más cuando el proveedor tiene un mal día.

Controla la diversidad mediante muestreo por núcleo: un valor de 0.5 significa que se considera la mitad de las opciones ponderadas por verosimilitud, y los valores bajos ignoran las menos probables.

• Top P: un número. La recomendación general es tocar este o Sampling Temperature, pero no los dos a la vez.

Asocia la respuesta a una conversación guardada en el lado del proveedor. Los items de entrada y de salida de esa respuesta se añaden a la conversación en cuanto termina.

• Conversation ID: una cadena, casi siempre una expresión como {{ $json.conversation }} que trae el item, para que un hilo equivalga a una conversación.

Una clave que OpenAI usa para cachear respuestas de peticiones parecidas y mejorar así la tasa de aciertos de caché.

• Prompt Cache Key: una cadena que eliges tú. El mismo valor para las peticiones que deben compartir caché, valores distintos para las que no.

Un identificador estable que ayuda a OpenAI a detectar usuarios de tu aplicación que puedan estar incumpliendo sus políticas de uso.

• Safety Identifier: una cadena que identifica a cada usuario de forma única, estable entre sus peticiones en lugar de regenerarse en cada ejecución.

Elige el nivel de servicio con el que sale la petición, que es la manera de avisar al proveedor de que esta llamada concreta importa más, o menos, que el resto de tu tráfico.

• Auto (auto) y Default (default): las rutas estándar.
• Flex (flex): el nivel indicado para trabajo que puede esperar, normalmente un lote que nadie vigila.
• Priority (priority): el que va para lo que no puede.

Adjunta información estructurada al objeto, útil para guardar contexto extra y para volver a encontrar esos objetos luego a través de la API o del dashboard.

• Metadata: un JSON con un máximo de 16 pares clave-valor. Las claves son cadenas de 64 caracteres como mucho, los valores cadenas de 512 como mucho.

Devuelve los tokens más probables en cada posición de la respuesta, cada uno con su logaritmo de probabilidad. La respuesta pasa a ser inspeccionable, no solo legible.

• Top Logprobs: un entero entre 0 y 20, el número de tokens candidatos que se devuelven por posición.

Recurre a una plantilla de prompt reutilizable configurada en el dashboard de OpenAI, en lugar de a un prompt escrito dentro del flujo.

• Prompt ID: el identificador único de la plantilla que se va a usar.
• Version: una versión opcional de esa plantilla, para que un retoque en el dashboard no llegue a producción sin que lo pidas.
• Variables: los valores JSON que se sustituyen dentro de la plantilla, construidos a menudo desde los campos {{ $json }} del item entrante.