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 the live rate-limit and quota page for your provider account
Provider limits vary by account, model, region, and current billing status.
ProRank also applies a short per-user burst guard. Wait a few minutes before retrying a large batch.
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
- Confirm the model is enabled for your provider account and region
- Choose a model from the current catalogue shown in AI Configuration instead of typing an older model ID
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 [REMOVED HISTORICAL CREDENTIAL]"
# Test Anthropic
curl https://api.anthropic.com/v1/messages \
-H"x-api-key: [REMOVED HISTORICAL CREDENTIAL]" \
-H"anthropic-version: 2023-06-01"Still Need Help?
Support Channels
- • ProRank Support: support@prorank.io
- • Documentation: prorank.io/docs
- • Support Center: prorank.io/support
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.