Skip to main content

Setting Up Your AI Search API Key

Required add-on: Ai Search

The AI Search add-on uses an external AI provider to power semantic search across your episode content. You choose which provider to use, and you can switch providers at any time from Settings → AI Search. How the providers differ is on Setting Up AI Search.

Each provider requires an API key that you generate from their platform and paste into Benecaster. The key stays on your server and is never sent to benecaster.com.


OpenAI

Platform: platform.openai.com

To get your key:

  1. Create an account at platform.openai.com or sign in.
  2. In the left navigation, go to API keys.
  3. Click Create new secret key. Give it a name (e.g. “Benecaster AI Search”) and click Create secret key.
  4. Copy the key immediately — OpenAI shows it once. If you close the dialog without copying, delete the key and create a new one.

Billing: OpenAI requires a payment method before API keys will process requests. Go to Settings → Billing to add a card and set a usage limit. Indexing costs a little once per episode, and each search after that costs very little.

Permissions: The default “All” permission is fine. You don’t need to restrict the key to specific endpoints.


Google Gemini

Platform: aistudio.google.com

To get your key:

  1. Go to Google AI Studio and sign in with your Google account.
  2. Click Get API key in the left sidebar, then Create API key.
  3. Select a Google Cloud project (or let AI Studio create one for you).
  4. Copy the generated key.

Billing: Google AI Studio has a free tier with generous daily limits — sufficient for most podcast-scale AI Search installations. If your episode library is large or your search volume is high, you can enable billing in Google Cloud Console to lift the rate limits.

Note: The API key is tied to your Google Cloud project. If you ever need to rotate the key, generate a new one in Google AI Studio and update the key in Benecaster Settings → AI Search.


Cohere

Platform: dashboard.cohere.com

To get your key:

  1. Create an account at dashboard.cohere.com or sign in.
  2. In the left navigation, go to API keys.
  3. Click New API key, give it a name, and click Generate.
  4. Copy the key from the table — you can view it again from the dashboard if needed.

Billing: Cohere offers a free trial tier with a monthly token allowance that is usually sufficient to index a podcast back-catalog. For ongoing use, billing is pay-as-you-go. Add a payment method under Settings → Billing if you hit the trial limit. A trial key is also limited to 40 calls a minute; AI Search waits and retries rather than failing, so indexing a large back catalog on one is slow.


Anthropic

Platform: platform.claude.com

To get your key:

  1. Create an account at platform.claude.com or sign in.
  2. Go to API keys.
  3. Click Create key, give it a name (e.g. “Benecaster AI Search”), and click Create.
  4. Copy the key — Anthropic shows the full value once. Store it securely before closing the dialog.

Billing: Anthropic requires a payment method before keys will process requests. Go to Settings → Plans & Billing to add a card. With Anthropic, each search reads your episode list, so each search costs more than with an indexing provider; the model you choose on Settings → AI Search makes the biggest difference.


Entering Your Key in Benecaster

Once you have your API key:

  1. In your WordPress admin, go to Benecaster → Settings → AI Search.
  2. Select your provider from the Provider dropdown.
  3. Paste your API key into the API key field.
  4. Click Test connection. It checks the key with your provider for free and searches nothing.
  5. Click Save settings.

If you’re running Benecaster’s setup wizard, its Connect your search API. step asks for the same provider and key, and saves them once Test connection passes. A site that finished setup before AI Search was switched on is invited to run that step instead, listed as Connect AI Search. Either way, the key ends up on Settings → AI Search. See Setting Up AI Search.

If the key fails the test, the message reads {Provider} did not accept the API key. Check it, or replace it with a new one. Double-check that you copied it fully (no leading or trailing spaces) and that billing is active on the provider’s platform if required.


Rotating or Replacing Your Key

If you need to change your API key — because a key was exposed, you’re switching providers, or a key was deleted on the provider’s platform — click Replace on Settings → AI Search, enter the new key, test it and save. AI Search uses the new key for every request from then on. A new key for the same provider keeps your search index as it is. Switching to a different provider re-indexes your episodes in the background.

See Also

Need this built rather than just documented? See our services →

Last updated