Skip to content

Connect your API keys

Most of the toolkit needs no API keys at all. You only need them for the skills that generate images or video, because those call outside services to do the rendering.

You bring your own keys, so usage is billed to your own accounts. Each key is read only from your computer’s environment, and if a skill needs a key you haven’t set, it stops and tells you rather than producing a broken or placeholder file.

ToolWhat it powersKeys you needGet them at
GeminiImage generationGEMINI_API_KEYaistudio.google.com/apikey
CreatifyVideo ads + batch image generationCREATIFY_API_ID, CREATIFY_API_KEYapp.creatify.ai → Settings → API
GitHub (optional)Hosting local reference imagesGITHUB_TOKEN, GITHUB_OWNER, GITHUB_REPOOnly needed if you reference local image files. You can skip it by passing public image URLs instead.

The skills read these from your environment. Set them once and they stick. Pick your operating system:

  1. Open the Terminal app (it comes with your Mac: press ⌘-Space, type “Terminal”, press Enter).

  2. Paste these lines, replacing the placeholder text with your real keys:

    Terminal window
    echo 'export GEMINI_API_KEY="your-key-here"' >> ~/.zshrc
    echo 'export CREATIFY_API_ID="your-id-here"' >> ~/.zshrc
    echo 'export CREATIFY_API_KEY="your-key-here"' >> ~/.zshrc
  3. Quit and reopen the Claude Code desktop app so it picks up the new keys.

  1. Open PowerShell (press the Start button, type “PowerShell”, press Enter).

  2. Paste these lines, replacing the placeholder text with your real keys:

    Terminal window
    setx GEMINI_API_KEY "your-key-here"
    setx CREATIFY_API_ID "your-id-here"
    setx CREATIFY_API_KEY "your-key-here"
  3. Fully quit and reopen the Claude Code desktop app. setx only takes effect in apps opened after you run it, so the restart is required.

Run an image skill (for example, meta-image-ad-generator). If your keys are set, it generates. If a key is missing, it stops with a plain message telling you exactly which key to add. It will never quietly ship a gray placeholder where an image should be.

Stuck? See Troubleshooting.