Introduction
Anthropic is a Copy Studio provider — it drives AI ad-copy generation with the Claude family of models. It does not power image or video generation; use other providers for those (e.g. Gemini or OpenAI for images; Gemini/Veo, Runway, or fal.ai for video). This guide walks you through getting a Claude API key, adding it in MagicAds, and the Claude models it unlocks.How keys are stored
All AI provider keys live in the AI Settings screen and are stored encrypted in the database. There are no.env edits — keys are injected into the drivers at runtime. Users never supply their own key; every generation runs on the admin’s key.
A model only becomes available to users when both are true: the Anthropic API key is saved and the model is enabled in the vendor modal.
Before you start
- Admin access to your MagicAds platform.
- An Anthropic account with billing/credits set up.
Part 1 — Get your Anthropic API key
Sign in to the Claude Console
Go to the Anthropic Console and sign in or create an account. Anthropic usually requires a verified phone number to activate API access.
Add billing / credits
Open Settings → Billing and add a payment method or purchase credits. Anthropic does not include free API credits with every account, so add a small balance so your key can make calls. Anthropic charges you directly for usage — separate from your MagicAds platform credits.
Create an API key
Go to Settings → API Keys (direct link: console.anthropic.com/settings/keys) and click Create Key. Name it clearly (e.g. “MagicAds”) and, if prompted, select the workspace it belongs to.
Part 2 — Add the key in MagicAds
Paste the key
Paste your API key into the API key field. Leaving it blank keeps the existing key unchanged.
Enable the models you want
Toggle on the Claude models you want to offer and set each model’s credit cost (what a user is charged per generation).
There is no “test connection” button. To verify, enable a model and run a quick generation in the Copy Studio.
Part 3 — Supported Anthropic models
Copy Studio
| Model | Model ID | Tier | Default credits | Best for |
|---|---|---|---|---|
| Claude Opus 4.8 | claude-opus-4-8 | Premium | 4 | Most capable Claude — complex, premium, high-stakes copy. |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | Standard | 2 | Best balance of speed and intelligence; strong default. |
| Claude Haiku 4.5 | claude-haiku-4-5 | Fast | 1 | Fastest Claude with near-frontier quality; great for high-volume runs. |
Credit costs shown are the seeded defaults. You can change any model’s cost in the vendor modal. These are what your platform charges users in credits — not Anthropic’s prices.
Part 4 — Make Claude the default copy engine (optional)
In the global section of AI Settings you can set the default copy engine to Anthropic so Claude is pre-selected for users. You can also toggle the Copy Studio on/off and control free-tier access there.Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Claude models don’t appear in Copy Studio | Key missing or models disabled | Add the key in the Anthropic vendor modal and enable the models, then Save. |
| ”The payload is invalid.” on generate | Saved key can’t be decrypted (e.g. after an environment change) | Re-enter the Anthropic key in AI Settings and Save to refresh it. |
| Anthropic API errors / 401 | Invalid key or no billing/model access | Re-check the key, credits, and model access in the Claude Console. |
| One Claude model fails but others work | Account lacks access to that model | Disable that model or enable a tier your account can use. |
| Looking for Claude image/video | Not supported | Claude is copy-only here; use an image/video provider instead. |
Keys are stored encrypted and applied at runtime. No
.env changes or commands are needed after saving.