Api Setup Guide

API Configuration Guide

That’s a very clear and well-structured API setup guide! It covers all the essential steps a user needs to get started.

Groq API Setup

Groq offers incredibly fast, free-tier access for AI inference, making it an ideal choice for the core functionality of Super Programmatic SEO.

Creating Your Groq Account

Step 1: Visit Groq Console

Open your web browser and go to the Groq Developer Console: https://console.groq.com/

Step 2: Sign In or Sign Up

  • Click “Sign In” or “Sign Up” in the top right corner.
  • You can use your existing Google account for quick sign-up or register with an email and password.
  • Complete the registration process and accept the terms of service.
  • You should be taken to the Groq Console dashboard.

Generating Your API Key

Step 3: Access API Keys Section

  • In the left sidebar of the Groq Console, click on “API Keys”.

Step 4: Create API Key

  • Click the “Create API Key” button.
  • Give your new key a descriptive name (e.g., “WordPress Plugin”).
  • You do not need to set any permissions or expiration.
  • Click “Create”.
  • Copy the generated key immediately – this is the only time it will be fully displayed!

Step 5: Secure Your API Key

  • The key will start with sk_.
  • Store it in a secure location. This key is your credential for using the Groq AI service.

Configuring in WordPress

Step 6: Plugin Configuration

  • In your WordPress admin, go to Super Programmatic SEO → API Settings.
  • Find the “Groq API Key” field.
  • Paste your copied API key into the field.
  • Click “Save Settings”.

You should now see the Groq configuration marked as complete on the plugin dashboard, and you can start generating ultra-fast articles with the FREE version!

Usage Guidelines (Groq)

  • Free Tier Limits: Groq offers generous usage on its free tier, which is more than sufficient for the free version of this plugin.
  • Monitoring: You can monitor your usage (requests and tokens) in the Groq Console dashboard under the “Usage” section.
  • Speed: Groq is known for its high-speed inference, which will significantly reduce the time it takes to generate your articles compared to many other providers.

Google Gemini API Setup

Creating Your Google Account

Step 1: Access Google AI Studio

  • Open your web browser and go to: https://aistudio.google.com/
  • Click “Get Started” or “Sign In” in the top right corner
  • If you don’t have a Google account, click “Create account” and follow the prompts

Step 2: Sign In to Google AI Studio

  • Use your existing Google account credentials
  • If this is your first time, accept the terms of service
  • You should see the Google AI Studio dashboard

Generating Your API Key

Step 3: Create API Key

  • In the left sidebar, click on “API Keys”
  • Click the “Create API Key” button
  • Select “Create API Key in new project”
  • Copy the generated key immediately – you won’t see it again!

Step 4: Secure Your API Key

  • The key will start with “AIza”
  • Store it in a secure location
  • Never share your API key publicly
  • This key is free but has usage limits

Configuring in WordPress

Step 5: Plugin Configuration

  • In your WordPress admin, go to Super Programmatic SEO → API Settings
  • Find the “Google Gemini API Key” field
  • Paste your copied API key
  • Click “Save Settings”
  • You should see a success message

Hugging Face API Setup

Creating Your Hugging Face Account

Step 1: Account Registration

  • Visit: https://huggingface.co/
  • Click “Sign Up” in the top right corner
  • Choose your sign-up method (email, Google, or GitHub)
  • Complete the registration process
  • Verify your email address if required

Step 2: Account Verification

  • Check your email for verification link
  • Click the link to activate your account
  • Return to Hugging Face and sign in

Generating Access Token

Step 3: Access Token Creation

  • Once signed in, click your profile picture in top right
  • Select “Settings” from dropdown menu
  • Click “Access Tokens” in left sidebar
  • Click “New token” button

Step 4: Token Configuration

  • Give your token a name like “WordPress SEO Plugin”
  • Set role to “Read” (this is sufficient for our plugin)
  • Click “Generate a token”
  • Copy the token immediately – it will only show once!

Plugin Configuration

Step 5: WordPress Setup

  • Go to Super Programmatic SEO → API Settings in WordPress
  • Find the “Hugging Face Access Token” field
  • Paste your copied token
  • Save the settings
  • Test by generating a sample article

Troubleshooting Common Issues

API Key Problems

Error: “Invalid API Key”

  • Verify you copied the entire key without extra spaces
  • Ensure you’re using the correct key type (API key vs Access Token)
  • Check if the service is experiencing outages
  • Verify your account has not reached usage limits

Error: “Authentication Failed”

  • Confirm you’re signed into the correct account
  • Check if the API key has been revoked or regenerated
  • Verify the key has the correct permissions

Account Issues

Cannot Create Google Account

  • Ensure you’re using a supported email provider
  • Check if you already have a Google account with that email
  • Try using a different browser or incognito mode
  • Clear browser cache and cookies

Hugging Face Verification Problems

  • Check your spam folder for verification emails
  • Ensure you clicked the verification link
  • Try resending verification email from account settings
  • Contact Hugging Face support if issues persist

Usage Guidelines

Free Tier Limits

Google Gemini Limits

  • Approximately 60 requests per minute
  • 1500 requests per day free tier
  • Suitable for testing and small websites

Hugging Face Limits

  • Varies by model and usage
  • Generally generous for personal use
  • Monitor your usage in account dashboard

Best Practices

Security Recommendations

  • Never commit API keys to public repositories
  • Use environment variables for production sites
  • Regularly rotate your API keys
  • Monitor your usage and costs

Performance Tips

  • Start with small articles to test functionality
  • Use descriptive keywords for better results
  • Review generated content before publishing
  • Combine multiple related keywords in single articles

Getting Additional Help

Documentation Resources

  • Complete plugin documentation available in WordPress admin
  • Video tutorials on basic setup procedures
  • Frequently updated knowledge base

Community Support

  • WordPress.org support forums for free users
  • Community-driven solutions and tips
  • Regular plugin updates with bug fixes

Account Support

Remember: Both services offer free tiers suitable for testing the plugin. You only need to configure one API service to start generating content.

Scroll to Top