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

# API Configuration Issues

> Troubleshoot common API configuration problems

Fix common issues when setting up API keys in SoloEnt.

## Invalid API key

**Problem:** Error message says "Invalid API key" or authentication fails.

**Solutions:**

* Verify you copied the entire key without spaces
* Check if key has expired or been revoked
* Regenerate a new key from provider dashboard
* Ensure you're using the correct key format for the provider

## Connection fails

**Problem:** Cannot connect to AI model or requests timeout.

**Solutions:**

* Check your internet connection
* Verify Base URL format (for OpenAI-compatible APIs)
* Try without VPN or proxy
* Check if the provider service is operational
* Verify firewall isn't blocking the connection

## Rate limit exceeded

**Problem:** Error message says "Rate limit exceeded" or "Too many requests".

**Solutions:**

* Wait a few minutes before trying again
* Upgrade your API plan for higher limits
* Switch to a different model temporarily
* Check your provider dashboard for usage limits

## Model not available

**Problem:** Selected model doesn't work or returns errors.

**Solutions:**

* Verify the model ID is correct
* Check if you have access to this model
* Ensure your API tier includes this model
* Try a different model from the same provider

## Missing required fields

**Problem:** Cannot save configuration, fields are incomplete.

**Solutions:**

* For standard providers: Only API key is required
* For OpenAI-compatible: All three fields required (Base URL, API Key, Model ID)
* Double-check provider documentation for exact requirements
* Contact provider support if unsure

<Card title="Back to API Configuration" icon="key" href="../quickstart/api-configuration">
  Return to the main API setup guide
</Card>