How-to guides

Get an AI key

Where to create an API key for Claude, ChatGPT or Gemini, and how you pay for it.


DarkBird runs AI on your organization's own key. The interviews and scopes for your first 3 projects run on DarkBird's key, so you can try it first; everything after that needs a key of your own. This page covers getting one. To add it, see Connect your own AI key.

Careful

A ChatGPT or Claude subscription is not an API key. Those subscriptions cover the chat apps only. DarkBird needs API access, which each provider sells separately on its developer site and bills by usage.

Where to create a key

To useCreate the key inIt looks like
Claude (Anthropic)Anthropic's developer console, under API keyssk-ant-...
ChatGPT models (OpenAI)the OpenAI API platform, under API keyssk-...
Gemini (Google)Google AI Studio, under Get API keyA Google AI Studio API key
DeepSeekDeepSeek's API platform, under API keysA DeepSeek API key

Steps

  1. Sign in to the provider's developer site

    Use a company account rather than a personal one, so the key and its bill belong to the business.

  2. Set up billing

    API usage is billed separately from any chat subscription. Plan on adding a payment method or prepaid credit before the key does real work.

  3. Set a spending limit

    Providers let you cap monthly spend or send an alert at a threshold. Set one, so a busy month can't surprise you.

  4. Create the key and copy it

    Name it something like "DarkBird" so you can recognize and revoke it later. Some providers show the full key only once, so copy it straight away.

  5. Paste it into DarkBird

    Go to Settings → AI Key, pick the provider and paste the key. See Connect your own AI key.

What it costs

Your provider bills you directly, at its published rates; DarkBird adds no markup. Each interview turn sends your cards, calibration and the relevant expert knowledge along with the conversation, so interviews and scopes are where most of your usage goes. Your provider's usage page shows exactly what DarkBird spent, by day and by model.

Tip

You choose the model for each task under Model routing on the AI Key tab. A faster, cheaper model for classification and a more capable one for scopes is a sensible split.