# Luma Cloud

> Customer setup and public API documentation.

Base URL: https://api.lumaos.cloud/v1
Choose a model from authenticated GET https://api.lumaos.cloud/v1/models with the user's own key. Never request the key in a conversation or send it to a documentation page.

## Start here

- [Quickstart](https://lumaos.cloud/docs/quickstart): Create a key and complete one request.
- [Integrations](https://lumaos.cloud/docs/installations): Choose your IDE, agent or chat app.
- [API](https://lumaos.cloud/docs/api): Authentication, Chat Completions and Responses.
- [Models](https://lumaos.cloud/docs/models): Model IDs, reasoning effort, limits and prices.
- [SDKs](https://lumaos.cloud/docs/sdks): Python, JavaScript and HTTP examples.
- [Usage](https://lumaos.cloud/docs/usage): Subscription quota and API Wallet usage.
- [Billing](https://lumaos.cloud/docs/billing): Plans, Wallet funding and additional quota.
- [Troubleshooting](https://lumaos.cloud/docs/errors): Error codes and safe recovery.
- [SuperGPT](https://lumaos.cloud/docs/installations/supercodex): Desktop setup and updates.
- [Agent setup](https://lumaos.cloud/docs/agents): A scoped setup prompt for an assistant.
- [Support](https://lumaos.cloud/docs/support): What to include in a support request.

## Client instructions

- [Continue · VS Code & JetBrains](https://lumaos.cloud/docs/installations/continue/llms.txt): Add Luma Cloud to Continue while keeping your other models and editor settings.
- [Cline](https://lumaos.cloud/docs/installations/cline/llms.txt): Connect the Cline extension with its OpenAI Compatible provider.
- [Kilo Code](https://lumaos.cloud/docs/installations/kilo-code/llms.txt): Create a named Luma Cloud provider and select models from your API catalog.
- [Roo Code](https://lumaos.cloud/docs/installations/roo-code/llms.txt): Use the OpenAI Compatible provider with a model that supports native tool calling.
- [VS Code · Chat & Copilot](https://lumaos.cloud/docs/installations/vscode/llms.txt): Add Luma Cloud with VS Code's Custom Endpoint model provider.
- [JetBrains AI Assistant](https://lumaos.cloud/docs/installations/jetbrains/llms.txt): Use Luma Cloud in AI Assistant across supported IntelliJ-based IDEs.
- [Zed](https://lumaos.cloud/docs/installations/zed/llms.txt): Add Luma Cloud as a separate provider for Zed's own AI features.
- [Cursor](https://lumaos.cloud/docs/installations/cursor/llms.txt): A conditional chat connection using Cursor's OpenAI base URL override.
- [Windsurf / Devin Desktop](https://lumaos.cloud/docs/installations/windsurf/llms.txt): Use a separately configured OpenCode agent through ACP where your editor plan supports it.
- [OpenCode](https://lumaos.cloud/docs/installations/opencode/llms.txt): Add Luma Cloud alongside your existing providers in OpenCode's classic configuration.
- [OpenCode V2](https://lumaos.cloud/docs/installations/opencode-v2/llms.txt): Use the V2 provider format without replacing your current OpenCode setup.
- [OpenClaw](https://lumaos.cloud/docs/installations/openclaw/llms.txt): Add a custom Luma Cloud provider and select it for one agent session.
- [Aider](https://lumaos.cloud/docs/installations/aider/llms.txt): Connect Aider for a single terminal run using its OpenAI-compatible provider.
- [Codex CLI](https://lumaos.cloud/docs/installations/codex-cli/llms.txt): Use Luma's Responses API for one CLI session while preserving your normal OpenAI configuration.
- [Claude Code](https://lumaos.cloud/docs/installations/claude-code/llms.txt): Direct connection needs Anthropic Messages compatibility, which is not a documented Luma API interface.
- [Gemini CLI](https://lumaos.cloud/docs/installations/gemini-cli/llms.txt): Gemini CLI's documented connection uses Google services rather than a generic OpenAI-compatible provider.
- [Open WebUI](https://lumaos.cloud/docs/installations/open-webui/llms.txt): Chat with Luma Cloud through an OpenAI-compatible connection.
- [AnythingLLM](https://lumaos.cloud/docs/installations/anythingllm/llms.txt): Use Luma Cloud as the language model for your workspace.
- [LibreChat](https://lumaos.cloud/docs/installations/librechat/llms.txt): Add a Luma Cloud custom endpoint to your LibreChat installation.
- [Cherry Studio](https://lumaos.cloud/docs/installations/cherry-studio/llms.txt): Keep Luma Cloud in its own provider entry and choose its models in chat.
- [n8n](https://lumaos.cloud/docs/installations/n8n/llms.txt): Add Luma Cloud text generation to a workflow with an OpenAI Chat Model node.
- [Dify](https://lumaos.cloud/docs/installations/dify/llms.txt): Configure a Luma Cloud chat model for a Dify app or workflow.
- [Flowise](https://lumaos.cloud/docs/installations/flowise/llms.txt): Use a custom OpenAI-compatible chat model in a Flowise Chatflow.
- [Any OpenAI-compatible client](https://lumaos.cloud/docs/installations/openai-compatible/llms.txt): Connect another editor, agent or app that accepts a custom OpenAI API URL and key.

## Full setup reference

- [Combined quickstart and client guides](https://lumaos.cloud/llms-full.txt)

Each client guide includes a check date, official sources, limitations and verification steps. Documentation review is not a completed test in the user's app. Preserve existing configuration and ask before billable verification.