n8n + Luma Cloud

Before you start

• Create a named key in Dashboard → API. Use API Wallet credit, or an eligible Builder subscription key.
• Copy an exact model ID from the catalog returned for this key. Replace MODEL_ID_FROM_CATALOG wherever it appears below.
• Use a separate named key for this app. Paste it only into the app's credential field; keep it out of chat prompts, screenshots, shared configuration and workflow exports.
• An n8n version whose OpenAI credential exposes Base URL, with permission to create a workflow and credentials.

Get an API key and a model ID →

Set up n8n

1. Build a small manual workflow

   Create a workflow with Manual Trigger connected to Basic LLM Chain. Add OpenAI Chat Model to the chain's Model connector.

2. Create a separate credential

   In the model node, create an OpenAI credential named Luma Cloud. Enter your Luma key, set Base URL to https://api.lumaos.cloud/v1, leave Organization ID blank, and save.

3. Select the model

   Choose the Luma Cloud credential and the exact model ID from your catalog. If your version offers manual model entry, use it when discovery cannot select that ID. Keep Use Responses API off for this guide.

4. Enter a fixed prompt

   In Basic LLM Chain, set Prompt to Define below. Set Prompt (User Message) to “Reply with hello.” Leave Require Specific Output Format off for this first text reply.

5. Run and inspect the result

   Click Execute Workflow and inspect the Basic LLM Chain output. Keep this test manual; configure bounded retries and review usage before adding a schedule.

6. Use HTTP Request if the model node is incompatible

   Create Manual Trigger → HTTP Request. Set Method to POST, URL to https://api.lumaos.cloud/v1/chat/completions, Authentication to Generic Credential Type → Header Auth, then save a credential with Name Authorization and Value Bearer followed by your Luma key. Turn on Send Body, choose JSON → Using JSON and paste the body below. Keep the secret in the credential, not in the node body.

Credential type

OpenAI

Base URL

https://api.lumaos.cloud/v1

API Key

Your Luma Cloud API key

Organization ID

Leave blank

Model

MODEL_ID_FROM_CATALOG

Use Responses API

Off for this guide

Chain: Prompt

Define below

Chain: Prompt (User Message)

Reply with hello.

Require Specific Output Format

Off for the first test

{
  "model": "MODEL_ID_FROM_CATALOG",
  "messages": [
    {
      "role": "user",
      "content": "Reply with hello."
    }
  ],
  "stream": false
}

{{ $json.choices[0].message.content }}

Check the connection

1. One workflow item should produce a completed text answer in the chain output. A credential connection check alone does not test a prompt, model or tool.
2. After the reply, open Dashboard → Usage. Check API Wallet for a wallet key, or subscription usage for a Builder subscription key.
3. If the chain asks for chatInput, change Prompt to Define below or provide that field from the previous node. For the example above, Define below avoids needing an input field.

For errors or a request that stops, see troubleshooting. A visible model list alone does not confirm that a chat or editing task can complete.

What to expect

• Use this guide for the OpenAI Chat Model node. Other OpenAI operations, embeddings, uploaded files and hosted tools may require API features this connection does not provide.
• If your version cannot override Base URL or select the returned model, use an HTTP Request node with the request shown in the API quickstart instead.
• Workflow retries and background runs can spend additional credit. Avoid unlimited retries, especially after an uncertain network result.
• Keep custom sampling parameters unset for the first test. Built-in tools and structured output require compatible model features and separate verification.
• Model sub-nodes resolve expressions against the first input item. For batches needing different models or prompts, verify item handling explicitly before enabling production runs.

Troubleshooting n8n