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

# Troubleshooting

> Common issues and their solutions

## API Issues

<AccordionGroup>
  <Accordion title="API Key Not Working">
    If your API key isn't working:

    1. Verify the key is correctly copied
    2. Check if the key is active in Studio dashboard
    3. Ensure the key has required permissions
    4. Confirm the key is added in header: `x-hl-api-key`
  </Accordion>

  <Accordion title="Streaming Response Issues">
    If streaming isn't working:

    1. Verify your client supports streaming
    2. Check network connectivity
    3. Ensure correct endpoint usage
    4. Implement proper error handling
  </Accordion>
</AccordionGroup>

## Content & Response Issues

<AccordionGroup>
  <Accordion title="Content Moderation Blocks">
    If content is being blocked:

    1. Review content guidelines
    2. Check for prohibited content
    3. Modify input to comply with policies
    4. Contact support for clarification
  </Accordion>

  <Accordion title="Unexpected AI Responses">
    To improve response quality:

    1. Adjust temperature settings
    2. Check attached knowledge sources
    3. Update model parameters
  </Accordion>

  <Accordion title="Token Limit Errors">
    When hitting token limits:

    1. Reduce input length
    2. Split into smaller requests
    3. Optimize prompt structure
    4. Check plan limitations
  </Accordion>
</AccordionGroup>

## Integration Issues

<AccordionGroup>
  <Accordion title="Chatbot Not Appearing">
    If your chatbot isn't showing:

    1. Verify script placement in HTML
    2. Check domain whitelist settings
    3. Confirm chatbot is published
    4. Review browser console for errors
  </Accordion>
</AccordionGroup>

## Account & Billing

<AccordionGroup>
  <Accordion title="Access Denied">
    If you can't access features:

    1. Verify account status
    2. Check permission settings
    3. Review plan limitations
    4. Contact support if needed
  </Accordion>

  <Accordion title="Payment Issues">
    For billing problems:

    1. Verify payment method
    2. Check billing information
    3. Review transaction history
    4. Contact billing support
  </Accordion>
</AccordionGroup>

## Still Need Help?

If you're still experiencing issues:

1. Check our [FAQ](/guides/faq)
2. Review [API Documentation](/api-reference/introduction)
3. Email us at [support@hyperleapai.com](mailto:support@hyperleapai.com)
4. Include error messages and relevant details
