Themeisle Docs

Appearance

How to Fix OpenAI API Connection Errors in FreshRank ​

This article helps you resolve the most common OpenAI API errors in FreshRank, including an unconfigured or invalid API key, rate limit errors, and a failing Test Connection button.

In this article

"OpenAI API key is not configured" ​

Problem: You're trying to use FreshRank but haven't entered an API key yet.

Solution: Follow Step 2 in the OpenAI API Setup guide to add your API key in the Settings page.

"OpenAI API error (HTTP 401): Invalid API key" ​

Problem: The API key you entered is incorrect or has been revoked.

Solutions:

  1. Double-check that you copied the entire key (no extra spaces or missing characters)
  2. Go back to OpenAI platform and verify the key still exists
  3. If the key was deleted, create a new one and update FreshRank settings
  4. Make sure you're copying from the correct OpenAI account (if you have multiple)

"OpenAI API error (HTTP 429): Rate limit exceeded" ​

Problem: You've made too many API requests in a short time period.

Solutions:

  1. Wait 5-10 minutes and try again
  2. Avoid running bulk operations on many posts at once
  3. Consider upgrading your OpenAI plan for higher rate limits
  4. If this happens frequently, spread out your analysis tasks throughout the day

💡 Tip: You can check your OpenAI usage and rate limits at platform.openai.com/usage

Test Connection Button Shows an Error ​

Problem: The test connection fails even though you've entered a valid key.

Possible causes and solutions:

  1. Network/Firewall Issue
    • Your hosting provider may be blocking connections to OpenAI
    • Contact your host and ask them to allow connections to api.openai.com
  2. Insufficient OpenAI Credits
  3. PHP cURL Not Enabled
    • FreshRank needs the PHP cURL extension to connect to OpenAI
    • Contact your hosting provider to enable cURL if it's disabled
  4. Connection test failed
    • If you just opened a new OpenAI account the 'Test Connection' button might show a 'Connection test failed' error. Try running any AI-powered action in FreshRank (like running an analysis on a single article). If you don't get an error and analysis completes then you're all set and your API key is working. After some time the 'Test Connection' button will show a success message.
Was this helpful?