OpenCat Setup

OpenCat is a native AI chat app for iOS / macOS with a clean interface and support for custom APIs. This page covers both one-click setup via URL Scheme and manual configuration.

Before you start

Have a Lurus API KeyAPI KeyA secret credential for accessing the API, much like a password. Each Key can have its own quota and permissions.Learn more → ready (format sk-xxxxxxxxxxxxxxxx). Don’t have one yet? Head to Get an API Key.

Quick Setup (URL Scheme)

Tap the link below in a browser or notes app to jump straight to OpenCat with the configuration filled in automatically:

opencat://team/join?domain=https://hub.lurus.cn&token=YOUR_API_KEY

Replace YOUR_API_KEY with your own key (sk-xxxxxxxxxxxxxxxx) and open it in Safari.

iOS Shortcut (recommended)

In the iOS Shortcuts app, create an "Open URL" action, paste the address above with your key filled in, and save it to your home screen — so you can complete the setup in one tap the next time you switch devices.

---

Manual Configuration

If the URL Scheme doesn’t work (older versions of OpenCat don’t support it), configure it manually:

1. Open OpenCat → Settings (avatar in the top-right corner) → API Settings.

2. Choose "Custom API" and fill in:

   • API Host: https://hub.lurus.cn
   • API Key: your key (sk-xxxxxxxxxxxxxxxx)

3. Tap "Test Connection", and once it reports success, save.

---

Choosing a Model

OpenCat does not automatically fetch the model list — you need to enter the model name manually. Common models:

Model Name	Strengths
deepseek-chat	Great value, best for Chinese
deepseek-reasoner	Math and code reasoning
gpt-4o	Strongest all-round capability
claude-3-5-sonnet	Long text, creative writing
gemini-3-pro-preview	Multimodal, 1M context

See the full list at Supported Models.

---

FAQ

Connection test fails with "Invalid key"

• Confirm the API Host has no trailing slash (https://hub.lurus.cn, not https://hub.lurus.cn/)
• Confirm the API Key format is correct (starts with sk-)
• In the Lurus Console, confirm the key’s status is "Enabled"

No response after entering a model name

• Check the spelling of the model name (case-sensitive, e.g. gpt-4o not GPT-4o)
• Confirm your key has access to that model

Where is the configuration on the macOS version?

macOS entry point: menu bar OpenCat → Preferences (⌘,) → API tab, with the same configuration parameters as the iOS version.

Next Steps

Browse supported modelsGet an API KeySee the API quickstart