AI troubleshooting (keys, errors, limits)

Fix invalid keys, rate limits, network errors, and other common issues.

AI troubleshooting

Most AI issues fall into a small set of causes.

First: confirm the basics

  • You added a key for the provider you’re using (Gemini or GPT).
  • You’re online (AI requests go to the provider’s API).
  • You’re not pasting keys into public places (Discord, screenshots, etc).

If you don’t want AI at all, keep it disabled - the rest of Sulguni works normally.

“Invalid key” / “Unauthorized”

  • Double-check the key (no extra spaces).
  • Make sure the key belongs to the provider you selected (Gemini vs GPT).
  • If you rotated the key, update it in Sulguni settings.

“Missing key”

If AI features look enabled but nothing works:

  1. Open AI settings: AI setup
  2. Make sure at least one provider shows a saved key.
  3. Save, then retry.

“Rate limit” / “Too many requests”

  • Wait a bit and try again.
  • Shorten the prompt.
  • Check your provider account limits.

“Network error”

  • Confirm your Mac is online.
  • Try again on a different network/VPN configuration.
  • If your network blocks AI endpoints, you may need to allow the provider domain.

“It’s too expensive”

AI usage is billed by the provider attached to your key. If you want to limit costs:

  • use shorter prompts
  • avoid retry spam
  • disable AI when you’re not using it

Where your key is stored

AI keys are stored locally on your Mac (macOS Keychain). Sulguni doesn’t need your key on the website account.

Next steps