Configure Cloud AI
Connect your own cloud AI provider and understand what leaves your PC.
Follow the bold button names and numbered steps. Technical names are included only when you need to recognize a model or file inside the app.
Cloud AI uses your own provider account or API key. Local Waifu does not convert provider usage into a Local Waifu subscription; the provider may bill your account directly.
Add a provider
Goal
Connect a cloud provider and select a hosted model.
Before you start
- Review the provider’s pricing, data handling, and model access.
- Have a valid key or supported connected-account login.
- Turn off Offline Mode only when you intentionally want cloud use. While it is on, providers stay saved but are not used.
Steps
- Open Settings → Cloud AI. Providers are grouped as Frontier labs, Fast inference, Aggregators, and Asia, with Your own endpoints at the bottom (Chapter 32). Some providers also offer or use a subscription (a connected account such as ChatGPT login).
- Find the provider. A get a key link opens its key page.
- Paste the key into Paste your API key and select Save.
- Select Test. The row reports Key works. or Test failed.
- Open Settings → Models → Chat Models and find the provider under From your connected accounts. Direct providers are listed live. For very large aggregators, paste the exact model id you want.
- Select Use on the model you want.
- Send a short test.
Expected result
Requests for the selected role use the provider. Local character and memory storage remains on the computer. Embeddings stay local even when chat goes to the cloud. Keys live in a local JSON file with owner-only permissions.
Privacy note
The selected prompt, relevant conversation context, image, audio, or text leaves the computer when required by that cloud operation. Do not use a cloud route for information you do not want to send to that provider.
If something goes wrong
- If a model row says Needs API key, add the key in Settings → Cloud AI first.
- If the model list is empty, the key may not give access to chat models. The app says No chat models available for this key.
- Re-copy the key without spaces. To remove one, select Remove.
The cloud is a fallback only if you turn it on
In 1.8.0 a saved cloud key is not a silent backup for the local model. When the local engine is down, or she receives a photo that no local model can see, the message used to go to any cloud key you had saved. Now that happens only if you turn on Use the cloud when the local model can’t answer.
Where to find it
Open Settings → Performance → Network, next to Offline Mode. The switch is off by default.
What happens when it is on
The message goes to one of your saved cloud keys, and a note in the conversation tells you it happened (Your local model failed, so this reply came from a cloud provider instead.). The note appears each time, so you always know which replies left your computer.
Offline Mode wins. With Offline Mode on, the fallback never sends anything.