OpenAI Chat Model node#
Use the OpenAI Chat Model node to use OpenAI's chat models with conversational agents.
On this page, you'll find the node parameters for the OpenAI Chat Model node and links to more resources.
Credentials
You can find authentication information for this node here.
Parameter resolution in sub-nodes
Sub-nodes behave differently to other nodes when processing multiple items using an expression.
Most nodes, including root nodes, take any number of items as input, process these items, and output the results. You can use expressions to refer to input items, and the node resolves the expression for each item in turn. For example, given an input of five name values, the expression {{ $json.name }} resolves to each name in turn.
In sub-nodes, the expression always resolves to the first item. For example, given an input of five name values, the expression {{ $json.name }} always resolves to the first name.
Node parameters#
Model#
Select the model to use to generate the completion.
n8n dynamically loads models from OpenAI, and you'll only see the models available to your account.
Use Responses API#
OpenAI provides two endpoints for generating output from a model:
- Chat Completions: The Chat Completions API endpoint generates a model response from a list of messages that comprise a conversation. The API requires the user to handle conversation state manually, for example by adding a Simple Memory subnode. For new projects, OpenAI recommends to use the Responses API.
- Responses: The Responses API is an agentic loop, allowing the model to call multiple built-in tools within the span of one API request. It also supports persistent conversations by passing a conversation_id.
Toggle to Use Responses API if you want the model to generate output using the Responses API. Otherwise, the OpenAI Chat Model node will default to using the Chat Completions API.
Refer to the OpenAI documentation for a comparison of the Chat Completions and Responses APIs.
Built-in Tools#
The OpenAI Responses API provides a range of built-in tools to enrich the model's response. Toggle to Use Responses API if you want the model to have access to the following built-in tools:
- Web Search: Allows models to search the web for the latest information before generating a response.
- File Search: Allow models to search your knowledgebase from previously uploaded files for relevant information before generating a response. Refer to the OpenAI documentation for more information.
- Code Interpreter: Allows models to write and run Python code in a sandboxed environment.
Use with AI Agent node
Built-in tools are only supported when using the OpenAI Chat Model node in combination with the AI Agent node. Built-in tools aren't available when using the OpenAI Chat Model node in combination with a Basic LLM Chain node, for example.
Node options#
Use these options to further refine the node's behavior. The following options are available whether you use the Responses API to generate model output or not.
Frequency Penalty#
Use this option to control the chances of the model repeating itself. Higher values reduce the chance of the model repeating itself.
Maximum Number of Tokens#
Enter the maximum number of tokens used, which sets the completion length.
Presence Penalty#
Use this option to control the chances of the model talking about new topics. Higher values increase the chance of the model talking about new topics.
Sampling Temperature#
Use this option to control the randomness of the sampling process. A higher temperature creates more diverse sampling, but increases the risk of hallucinations.
Timeout#
Enter the maximum request time in milliseconds.
Max Retries#
Enter the maximum number of times to retry a request.
Top P#
Use this option to set the probability the completion should use. Use a lower value to ignore less probable options.
Additional node options (Responses API only)#
The following, additional options are available when toggling to Use Responses API.
Conversation ID#
The conversation that this response belongs to. Input items and output items from this response are automatically added to this conversation after this response completes.
Prompt Cache Key#
Use this key for caching similar requests to optimize cache hit rates.
Safety Identifier#
Apply an identifier to track users who may violate usage policies.
Service Tier#
Select the service tier that fits your needs: Auto, Flex, Default, or Priority.
Metadata#
A set of key-value pairs for storing structured information. You can attach up to 16 pairs to an object, which is useful for adding custom data that can be used for searching by the API or in the dashboard.
Top Logprobs#
Define an integer between 0 and 20 specifying the number of most likely tokens to return at each token position, each with an associated log probability.
Output Format#
Choose a response format: Text, JSON Schema, or JSON Object. Use of JSON Schema is recommended, if you want to receive data in JSON format.
Prompt#
Configure the prompt filled with a unique ID, its version, and substitutable variables. Prompts are configured through the OpenAI dashboard.
Templates and examples#
Related resources#
Refer to LangChains's OpenAI documentation for more information about the service.
Refer to OpenAI documentation for more information about the parameters.
View n8n's Advanced AI documentation.
Common issues#
For common questions or issues and suggested solutions, refer to Common issues.