Cherry Studio + 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.
• Cherry Studio with custom OpenAI providers.

Get an API key and a model ID →

Set up Cherry Studio

1. Create a separate provider

   Open Settings → Model Services → Add. Enter Luma Cloud as the name, select OpenAI as the provider type, and confirm Add. Keep any existing OpenAI provider entry.

2. Fill in the connection

   Select the new provider and enter your Luma key in API Key. Set API Address to https://api.lumaos.cloud/v1. Current versions recognize the existing /v1; a final slash is optional. If your version shows endpoint controls, select OpenAI Chat Completions for this guide and check that the URL preview ends in /v1/chat/completions.

3. Add the models you want

   Click Manage to fetch the model list, then click + beside a model to add it. For manual entry, use Add and enter the exact catalog ID as Model ID.

4. Enable and select

   Enable the provider switch. Return to chat, open a new conversation, and select the model under Luma Cloud in the model picker.

5. Send a first message

   Send “Reply with hello.” Use a text message without attachments for the first test.

Provider name

Luma Cloud

Provider Type

OpenAI

API Address

https://api.lumaos.cloud/v1

API Key

Your Luma Cloud API key

Model ID

MODEL_ID_FROM_CATALOG

Provider switch

Enabled

Check the connection

1. Wait for a completed reply from the model selected under Luma Cloud.
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 app returns 404, inspect the endpoint preview and confirm that the URL does not contain v1 twice. If the model is missing from chat, check that it was added in Manage and the provider is enabled.

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

• Leave embeddings, image generation and speech on separately configured providers.
• Interface labels can vary by Cherry Studio version. The required values are the OpenAI provider type, API address, key and exact model ID.
• Keep the Luma Cloud credential inside its own provider entry. Changing an existing OpenAI entry would also change the connection used by its saved models.

Troubleshooting Cherry Studio