Authentication
How API keys work and when you need one.
Two Modes
The API supports two authentication modes:
No Auth — Yadda Ipsum
No API key needed. Returns static Yadda Ipsum text structured into any template. Free, unlimited (1,000 requests/day per IP).
curl "https://api.yaddayadda.io/v1/generate?template=hero_section"Bearer Token — AI Generation
Required when using topic or tone parameters. Pass your API key as a Bearer token:
curl "https://api.yaddayadda.io/v1/generate?template=hero_section&topic=fintech" \
-H "Authorization: Bearer yda_live_abc123def456"API Key Format
| Prefix | Environment |
|---|---|
yda_live_ | Production |
yda_test_ | Sandbox |
Keys are hashed with SHA-256 before storage — plaintext is never stored. You'll only see the full key once, when it's created.
Getting a Key
- Sign up at yaddayadda.io
- Go to Dashboard → API
- Click Create API Key
- Copy the key — it won't be shown again
The Hobby tier is free and includes 500 AI generations per month.
When is a Key Required?
| Scenario | Key Required? |
|---|---|
No topic, no tone | No — returns Yadda Ipsum |
No topic, no tone, key provided | No — key is ignored, returns Yadda Ipsum |
topic and/or tone present, with key | Yes — returns AI-generated content |
topic and/or tone present, no key | Returns 401 error |
The free tier isn't degraded — it's the full structural product. The paid tier adds intelligence to the same structure.