> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerotwo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Timeouts and Errors

> Troubleshoot AI model timeout errors and connection issues in ZeroTwo

Model timeouts occur when AI models take too long to respond or when connections are interrupted. Learn how to identify and resolve these issues.

## Common timeout errors

<AccordionGroup>
  <Accordion title="Request timeout">
    **Error**: "Request timed out" or "Model took too long to respond"

    **Causes:**

    * Very long or complex prompts
    * Model provider experiencing high load
    * Network connectivity issues
    * Context window limits exceeded

    **Solutions:**

    1. **Simplify your prompt**: Break complex requests into smaller parts
    2. **Reduce context**: Remove unnecessary conversation history
    3. **Try again**: Temporary provider issues often resolve quickly
    4. **Switch models**: Try a faster model (GPT-4o-mini, Claude Haiku)
    5. **Check network**: Verify stable internet connection

    ```text theme={null}
    Instead of: "Analyze this entire 50-page document and provide detailed insights on every section"
    Try: "Summarize the key points from section 1 of this document"
    ```
  </Accordion>

  <Accordion title="Connection error">
    **Error**: "Connection lost" or "Failed to connect"

    **Solutions:**

    * Check internet connection
    * Disable VPN temporarily
    * Try different network
    * Clear browser cache
    * Disable browser extensions
    * Try incognito/private mode
  </Accordion>

  <Accordion title="Rate limit exceeded">
    **Error**: "Too many requests" or "Rate limit exceeded"

    **Causes:**

    * Sending requests too quickly
    * Reached usage limits for your plan
    * Provider-side rate limiting

    **Solutions:**

    1. Wait a moment before retrying
    2. Reduce request frequency
    3. Check your [subscription plan](/account/subscriptions)
    4. Upgrade for higher limits if needed
  </Accordion>
</AccordionGroup>

## Preventing timeouts

<Steps>
  <Step title="Optimize prompt length">
    * Keep prompts concise but clear
    * Remove redundant information
    * Use [structured prompting](/prompts/structured-techniques)
  </Step>

  <Step title="Manage context">
    * Start new conversations for unrelated topics
    * Clear old conversation history
    * Use [Memory](/tools/memory) instead of repeating context
  </Step>

  <Step title="Choose appropriate models">
    * Use faster models for simple tasks
    * Reserve powerful models for complex problems
    * See [model comparison](/overview/models-and-providers)
  </Step>

  <Step title="Monitor usage">
    * Track your usage patterns
    * Stay within plan limits
    * Upgrade if regularly hitting limits
  </Step>
</Steps>

<Tip>
  For very long documents, process them in sections rather than all at once. This prevents timeouts and provides better results.
</Tip>

## Related pages

<CardGroup cols={2}>
  <Card title="Switch models" icon="shuffle" href="/getting-started/switch-models">
    Choose appropriate models
  </Card>

  <Card title="Token limits" icon="gauge" href="/prompts/tokens-and-limits">
    Manage context efficiently
  </Card>

  <Card title="Report a bug" icon="bug" href="/troubleshooting/report-a-bug">
    Report persistent issues
  </Card>

  <Card title="Models overview" icon="brain" href="/overview/models-and-providers">
    Compare model capabilities
  </Card>
</CardGroup>