API and Provider Limits

Troubleshoot errors from your AI provider, including OpenAI, Anthropic, xAI / Grok, Google, or a Custom / Local endpoint.

For provider selection strategy, see AI Providers.

Quota Warning / Provider Limit Reached

Symptoms: You see an error such as Quota exceeded, insufficient quota, rate limit reached, or requests fail unexpectedly.
Cause: The selected AI provider has hit a limit on your account (e.g., usage quota, temporary rate limit, or billing issue).
Fix:
1. Wait and retry: Temporary rate limits often clear after a short period.
2. Check your account: Verify your AI provider account has a valid payment method and sufficient credits/quota. Provider usage is billed by the provider, separately from your Genie plan.
3. Refresh settings: In Genie Settings, confirm your API key is correct and valid.
4. Reduce context: Try a shorter prompt or attach fewer script steps to stay within token limits.
5. Switch providers: If possible, switch to a different provider (for example from OpenAI to xAI / Grok or Google) to continue working.

These are not API quotas. Claude Code and Codex use your own Claude or ChatGPT plan, and its limits apply.

Symptoms: a reply stops or fails with a message about a usage limit or your plan, and the same happens in Claude Code or Codex outside Genie.
Cause: you reached your plan’s usage limit at Anthropic or OpenAI. Those limits, and the terms behind them, belong to the publishers. Genie does not control or see them, and they may change.
Fix: wait for the limit to reset, check or change your plan with the publisher, or choose Genie’s own Agent with an API key in the model menu.

For install, sign-in and update errors, see Claude Code and Codex.

xAI / Grok uses a separate xAI API key in Settings.
It is a hosted provider, not a Custom / Local endpoint.
Web Search is not wired for xAI in this release; switch providers or turn Web Search off if Genie warns about that combination.