OpenAI node

Use the OpenAI node to automate work in OpenAI and integrate OpenAI with other applications. n8n has built-in support for a wide range of OpenAI features, including creating images and assistants, as well as chatting with models.

On this page, you’ll find a list of operations the OpenAI node supports and links to more resources.

Note

Previous node versions The OpenAI node replaces the OpenAI assistant node from version 1.29.0 on. n8n version 1.117.0 introduces V2 of the OpenAI node that supports the OpenAI Responses API and removes support for the to-be-deprecated Assistants API.

Note

Credentials Refer to OpenAI credentials for guidance on setting up authentication.

Operations

• Text

  • Generate a Chat Completion

  • Generate a Model Response

  • Classify Text for Violations

• Image

  • Analyze Image

  • Generate an Image

  • Edit an Image

• Audio

  • Generate Audio

  • Transcribe a Recording

  • Translate a Recording

• File

  • Delete a File

  • List Files

  • Upload a File

• Video

  • Generate a Video

• Conversation

  • Create a Conversation

  • Get a Conversation

  • Update a Conversation

  • Remove a Conversation

Templates and examples

Related resources

Refer to OpenAI’s documentation for more information about the service.

Refer to OpenAI’s assistants documentation for more information about how assistants work.

For help dealing with rate limits, refer to Handling rate limits.

What to do if your operation isn’t supported

If this node doesn’t support the operation you want to do, you can use the HTTP Request node to call the service’s API.

You can use the credential you created for this service in the HTTP Request node:

1. In the HTTP Request node, select Authentication > Predefined Credential Type.

2. Select the service you want to connect to.

3. Select your credential.

Refer to Custom API operations for more information.

Using tools with OpenAI assistants

Some operations allow you to connect tools. Tools act like addons that your AI can use to access extra context or resources.

Select the Tools connector to browse the available tools and add them.

Once you add a tool connection, the OpenAI node becomes a root node, allowing it to form a cluster node with the tools sub-nodes. See Node types for more information on cluster nodes and root nodes.

Operations that support tool connectors

• Text

  • Generate a Chat Completion

  • Generate a Model Response

Common issues

For common questions or issues and suggested solutions, refer to Common issues.