Open WebUI + 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.
• Administrator access to your own or a trusted Open WebUI installation.

Get an API key and a model ID →

Set up Open WebUI

1. Open connection settings

   Open Settings → Admin → Connections. In Manage OpenAI API Connections, click + Add Connection. Keep your existing connections.

2. Fill in the connection

   Paste https://api.lumaos.cloud/v1 into URL and your Luma key into API Key. Under Advanced, leave Provider at Default.

3. Limit the model list if needed

   To show only selected models, enter each exact catalog ID in Model IDs and click +. Leave this list empty to use automatic discovery.

4. Save and select

   Click Save and make sure the connection is enabled. Open a new chat, then choose your Luma model in the model selector.

5. Send your first message

   Type “Reply with hello.” Start with text only; add files or tools after the basic connection works.

URL

https://api.lumaos.cloud/v1

API Key

Your Luma Cloud API key

Provider

Default

Model IDs

Optional filter: MODEL_ID_FROM_CATALOG

Connection

Enabled

Check the connection

1. Wait for a completed text reply. Verify Connection checks the model list; it does not send your test message.
2. After the reply, open Dashboard → Usage. Check API Wallet for a wallet key, or subscription usage for a Builder subscription key.
3. If background titles or suggestions fail, check that their configured model is available to this same key.

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

• An administrator connection may be available to other users of that installation. Configure access before saving a personal key.
• This setup is for text chat. Document embeddings, image generation, speech and browser-direct connections need their own compatible setup; they are not enabled by adding this connection.
• Tools and background tasks can make additional model requests. Test one tool at a time after text chat succeeds, with a model that supports tool calling.

Troubleshooting Open WebUI