Revision #301

## BYOK: Anthropic API Key

The AI Community Manager and every other AI feature on your tenant runs on your own Anthropic API key. Mobieus has no fallback key. You sign up with Anthropic, you get billed by Anthropic, you keep full control.

This page walks through getting a key and configuring it.

For what the AI Community Manager does, see [AI Community Manager](/know/admin-automation-engine). For model selection and pricing, see [AI Model & Cost Control](/know/admin-config-ai-model).

---

## Why BYOK

3 reasons:

1. **No markup.** Mobieus does not resell tokens. You pay Anthropic's published rates, no Mobieus margin.
2. **Your billing relationship.** Spend limits, alerts, payment methods all live in your Anthropic console.
3. **Your data.** Anthropic's BYOK relationship gives you direct access to your usage logs and the option of Anthropic's privacy controls.

---

## Step 1: Get an Anthropic account

Visit [console.anthropic.com](https://console.anthropic.com) and create an account. Personal email or work email both work.

You need a credit card on file. Anthropic supports prepay credit and metered billing.

Anthropic's free tier gives you a small amount of credit to test with. Production use needs a paid plan.

---

## Step 2: Create an API key

From the Anthropic console:

1. Click **API Keys** in the sidebar.
2. Click **Create Key**.
3. Name it something memorable. Example: `mobieus-acme-community`.
4. Copy the key. It begins with `sk-ant-` followed by a long alphanumeric string.

Anthropic shows the key once. Save it somewhere safe. If you lose it, create a new one.

---

## Step 3: Add it to your tenant

1. Visit `/admin/ai` on your tenant (the AI Configuration page).
2. Paste the key into the **Anthropic API Key** field.
3. Click Save.

The platform stores the key in your tenant's environment and validates it with a small test call. You'll see a green confirmation if the key works.

Setting the key requires **Super Admin** role.

---

## Step 4: Set spend limits in Anthropic

In the Anthropic console:

1. Click **Limits** in the sidebar.
2. Set a monthly spend limit. Pick a number you're comfortable with.
3. Set an email alert at 80% of that limit.

If you hit the limit, Anthropic returns a 429 to the next request. The platform pauses AI features and shows a banner in `/admin/community-manager`. Raise the limit to resume.

---

## Step 5: Pick a model

The default model is **Claude Haiku 4.5**. To switch to Sonnet (smarter) or Opus (smartest), open the System section of `/admin/config` and pick a different model. The options are Claude Haiku 4.5, Claude Sonnet 4.5, and Claude Opus 4.5.

See [AI Model & Cost Control](/know/admin-config-ai-model) for the pricing matrix and per-feature overrides.

---

## Rotating your key

Rotate keys every 90 days or whenever an admin leaves your team.

1. In the Anthropic console, create a new key.
2. In `/admin/ai`, paste the new key and save.
3. In the Anthropic console, revoke the old key.

The platform uses the new key on the next generation. In-flight generations finish on whatever key they started with.

---

## What stops working without a key

Every AI feature on your tenant. The Community Manager's gate function checks 3 things on every generation:

1. Master flag `ai_community_manager_enabled` is on.
2. Your plan is Pro, Creator Plus, or Sovereign.
3. Your Anthropic API key is configured.

Any one closed and the whole AI subsystem is off. The admin UI shows you which gate is closed.

---

## Cost visibility

The platform tracks every token your key uses and shows you the rolling 30-day total on `/admin/config` (System section) and the AI Community Manager queue at `/admin/community-manager`.

Cross-check with the Anthropic console's usage tab. Numbers should match within a few cents (rounding to micro-USD).

---

## Access

Setting the key requires Super Admin role. The key is never displayed back in the UI after save (just a masked indicator that it's set).