Troubleshooting & FAQ
Solutions to common issues and answers to frequently asked questions
Common Issues & Solutions
Quick fixes for the most common AI Tools problems
Invalid API Key Error
The API key you entered is not being accepted by the provider.
Solutions:
- Verify you copied the entire key including prefixes (sk-proj-, etc.)
- Check for extra spaces before or after the key
- Ensure the key hasn't been revoked or regenerated
- Confirm you're using the correct provider's key
Correct format examples:
OpenAI: sk-proj-xxxxxxxxxxxxxxxxxxxxx
Anthropic: sk-ant-xxxxxxxxxxxxxxxxxxxxx
Gemini: AIzaSyxxxxxxxxxxxxxxxxxx
DeepSeek: sk-xxxxxxxxxxxxxxxxxxxxxInsufficient Credits / Billing Error
API requests are failing due to billing or credit issues.
Solutions:
- Add a payment method to your AI provider account
- Check if you've hit monthly spending limits
- For OpenAI: Ensure you have credits in your account
- For Gemini: Verify you're within free tier limits
Rate Limit Exceeded
Too many requests sent to the AI provider in a short time.
Solutions:
- Wait a few minutes before trying again
- Reduce the frequency of your requests
- Check your provider's rate limits:
• OpenAI: 3-500 RPM depending on tier
• Anthropic: 5-50 RPM depending on model
• Gemini Free: 60 RPM
• DeepSeek: 100 RPM
Model Not Available
The selected AI model is not accessible with your API key.
Solutions:
- Verify your API tier has access to the model
- Try selecting a different model
- Check if the model requires special access (GPT-5, Claude 4)
- Ensure model name is spelled correctly in settings
Connection Timeout / Network Error
Unable to connect to the AI provider's servers.
Solutions:
- Check your internet connection
- Verify the provider's API is not down (check status pages)
- Ensure your firewall isn't blocking API requests
- Try again in a few moments
Frequently Asked Questions
Diagnostic Steps
Follow these steps to diagnose AI configuration issues
Test Connection
Go to AI Configuration and click "Test Connection" to verify your API key
Check Error Logs
Look for specific error messages in WordPress debug log
# Enable WordPress debugging
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
# Check logs at:
/wp-content/debug.logVerify Provider Status
Check if your AI provider is experiencing issues:
- • OpenAI Status: status.openai.com
- • Anthropic Status: status.anthropic.com
- • Google Cloud Status: status.cloud.google.com
- • DeepSeek: Check their platform
Test with cURL
Test your API key directly from command line:
# Test OpenAI
curl https://api.openai.com/v1/models \
-H"Authorization: Bearer YOUR_API_KEY"
# Test Anthropic
curl https://api.anthropic.com/v1/messages \
-H"x-api-key: YOUR_API_KEY" \
-H"anthropic-version: 2023-06-01"Still Need Help?
Support Channels
- • ProRank Support: support@prorank.com
- • Documentation: docs.prorank.com
- • Community Forum: community.prorank.com
Information to Provide
- • WordPress version
- • ProRank SEO version
- • AI provider and model
- • Error messages (exact text)
- • Debug log excerpts
Never share your API keys in support tickets or public forums. Our support team will never ask for your API keys.