Skip to content
cloakray
DashboardGet API key

Search guides, API endpoints, integrations and coding agents.

Docs · n8n

n8n

n8n's OpenAI Chat Model node works with Cloakray through an OpenAI credential with a different base URL.

Add the credential

In n8n, create a new OpenAI credential:

FieldValue
API KeyYour Cloakray key
Organization IDLeave blank
Base URLhttps://api.cloakray.com/v1

Keep the key in the credential rather than in a workflow expression or prompt.

Build a workflow

  1. Add an On chat message trigger.
  2. Connect it to an AI Agent node.
  3. Under the agent's Chat Model connector, add OpenAI Chat Model and select the credential.
  4. Turn Use Responses API off, set the model selector to By ID, and enter a model ID from the catalogue, such as gpt-5.5 or claude-sonnet-4-6.
  5. Click Open chat and send a message.

For agents that call tools, pick a model with tool support. The other OpenAI nodes — embeddings, image generation — take the same credential.

Troubleshooting

  • Authentication fails — check the key and that the base URL ends in /v1.
  • The model is missing from the list — choose By ID and type the model ID.
  • Requests fail — confirm Use Responses API is off, and check the failing step's error message.