API setup · No direct connection
Gemini CLI + Luma Cloud
Gemini CLI's documented connection uses Google services rather than a generic OpenAI-compatible provider.
This client does not offer a verified direct Luma Cloud connection. Follow the alternatives below. SuperGPT desktop installation and sign-in are separate.
Before you start
- Use a client with a documented OpenAI-compatible custom provider for direct Luma API access.
Set up Gemini CLI
- Check the supported connection
Gemini CLI documents Google sign-in, a Gemini API key, and Vertex AI. GOOGLE_GEMINI_BASE_URL changes the destination of Gemini-format requests; it does not turn them into Chat Completions or Responses.
- Use a compatible agent
Choose OpenCode, Aider, or another client in this directory for Luma. Keep your Google login and Gemini CLI settings unchanged.
Check the connection
- No direct Luma setup is claimed for Gemini CLI. Verify the alternative client using its own guide.
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
- Do not enter a Luma key as GEMINI_API_KEY or assume that an OpenAI-compatible URL supports Gemini's API format.
- Luma does not document a Gemini/Vertex endpoint. A separate translator would need its own compatibility testing.
Troubleshooting Gemini CLI
GOOGLE_GEMINI_BASE_URL points to Luma but requests fail
The setting changes where Gemini-format requests go; it does not translate them into Chat Completions. Restore the override you added and use a documented OpenAI-compatible client for Luma.
GEMINI_API_KEY rejects the Luma key
These keys belong to different services. Keep your Google credentials in Gemini CLI and enter the Luma portable key only in a compatible client's own configuration.
A Google sign-in or Gemini model picker succeeds
That verifies the Google connection, not Luma billing or API access. For a Luma test, follow the OpenCode or Aider guide and check the matching named key in the Luma dashboard.
Client documentation
Settings checked on 2026-09-28. These instructions are based on the client’s documentation; installed versions may differ.