# Anthropic API

## Anthropic (Claude) API Setup

Connect your Anthropic API key to use Claude models for content generation. Claude excels at nuanced, natural-sounding content.

***

### Why Claude?

Anthropic's Claude models are known for:

* **Natural writing style** — less "AI-sounding"
* **Long-form content** — handles complex, lengthy articles well
* **Instruction following** — excellent at matching tone and style
* **Thoughtful responses** — better at nuanced topics

Many Cuppa users prefer Claude for their final, published content.

***

### Available Models

| Model                 | Best For                | Cost   | Quality   |
| --------------------- | ----------------------- | ------ | --------- |
| **Claude Haiku 4.5**  | Bulk generation, drafts | Lowest | Good      |
| **Claude Sonnet 4.5** | Balanced quality/cost   | Medium | Excellent |
| **Claude Opus 4.5**   | Premium content         | Higher | Best      |
| **Claude Opus 4.1**   | Advanced tasks          | Higher | Excellent |

> **Recommendation**: Claude Sonnet 4.5 offers the best balance of quality and cost.

***

### Step 1: Create an Anthropic Account

1. Go to [console.anthropic.com](https://console.anthropic.com)
2. Click **Sign Up**
3. Verify your email
4. Complete account setup

***

### Step 2: Add Payment Method

Anthropic requires a payment method before generating API keys:

1. Go to **Settings** → **Plans & Billing**
2. Click **Add payment method**
3. Enter your credit card details
4. Add credits ($5-20 to start)

***

### Step 3: Generate Your API Key

1. Go to [console.anthropic.com/settings/keys](https://console.anthropic.com/settings/keys)
2. Click **Create Key**
3. Name it "Cuppa" (optional)
4. Click **Create Key**
5. **Copy the key immediately** — you won't see it again!

Your key looks like: `sk-ant-api03-xxxxxxxxxxxxxxxxxxxx`

***

### Step 4: Add Key to Cuppa

1. Log in to [app.cuppa.ai](https://app.cuppa.ai)
2. Go to **Team Settings** → **API Keys**
3. Find the **Anthropic** section
4. Paste your API key
5. Click **Save**

***

### Using Claude in Cuppa

Once connected, select Claude models when generating:

#### Single Generation

1. Go to **Create Content** → **Single Generation**
2. In the model dropdown, select **Claude Sonnet 4.5** (or another Claude model)
3. Continue with normal generation

#### Bulk Generation

1. Go to **Create Content** → **Bulk Generation**
2. Select a Claude model in settings
3. All articles in the batch will use Claude

#### In Presets

1. Go to **Saved Presets** → **My Presets**
2. Create or edit a preset
3. Set the default model to Claude
4. All content using that preset will use Claude

***

### Claude vs GPT Comparison

| Feature                | Claude       | GPT-4o          |
| ---------------------- | ------------ | --------------- |
| Writing style          | More natural | More structured |
| Long content           | Excellent    | Good            |
| Following instructions | Excellent    | Excellent       |
| Speed                  | Fast         | Fast            |
| Cost (per article)     | \~$0.10-0.30 | \~$0.10-0.25    |

**When to use Claude:**

* Final, published content
* Brand voice matching
* Nuanced topics
* Long-form guides

**When to use GPT:**

* Bulk drafts
* Technical content
* Structured formats
* Cost optimization

***

### Rate Limits

Anthropic has rate limits based on your usage tier:

| Tier       | Requirement | Requests/min |
| ---------- | ----------- | ------------ |
| **Tier 1** | New account | 60           |
| **Tier 2** | $100+ spent | 1,000        |
| **Tier 3** | $500+ spent | 2,000        |

For bulk generation, Tier 2 is recommended.

***

### Cost Management

#### Monitoring Usage

1. Go to [console.anthropic.com/settings/usage](https://console.anthropic.com/settings/usage)
2. View current spend and limits
3. Set spending limits if needed

#### Typical Costs

| Content Type                | Model             | Estimated Cost |
| --------------------------- | ----------------- | -------------- |
| Single article (2000 words) | Claude Haiku 4.5  | $0.02-0.05     |
| Single article (2000 words) | Claude Sonnet 4.5 | $0.10-0.25     |
| Bulk project (100 articles) | Claude Haiku 4.5  | $2-5           |
| Bulk project (100 articles) | Claude Sonnet 4.5 | $10-25         |

***

### Important Note

**OpenAI is still required** even when using Claude. Cuppa uses GPT-4o-mini for certain internal features:

* Outline generation
* SEO metadata
* Content optimization

Make sure you have both keys connected for the best experience.

***

### Troubleshooting

#### "Invalid API key"

* Check you copied the full key (starts with `sk-ant-`)
* Verify the key exists in Anthropic console
* Create a new key if needed

#### "Rate limit exceeded"

* Wait 1 minute and retry
* Check your Anthropic tier
* Consider using GPT for bulk, Claude for final edits

#### "Insufficient credits"

* Add more credits at [console.anthropic.com](https://console.anthropic.com)
* Set up auto-recharge to avoid interruptions

#### "Model not available"

* Ensure you're using a current model name
* Some older models may be deprecated
* Try Claude Sonnet 4.5 (most reliable)

***

### FAQ

**Do I need both OpenAI and Anthropic?**

OpenAI is required. Anthropic is optional but recommended for higher-quality content.

**Can I use Claude for everything?**

You can use Claude for all main content generation. Some internal Cuppa features still require OpenAI.

**Which Claude model is best for articles?**

Claude Sonnet 4.5 is the sweet spot — excellent quality at reasonable cost.

**Is Claude better than GPT?**

For natural-sounding content, many users prefer Claude. For structured/technical content, GPT often works better. Try both!

**How do I switch between models?**

Select the model in the generation settings. You can also set a default in your presets.

***

### Related Docs

* OpenAI API Setup — Required for all users
* Model Comparison — Detailed model comparison
* Presets Guide — Save your preferred model settings