> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adskull.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Authenticate public API calls with scoped API keys.

Use a bearer token on every public API request.

```http theme={"theme":"github-dark"}
Authorization: Bearer sk_live_...
```

## Key Rules

* API keys are available only to Creator and higher plans.
* Keys are shown once during creation.
* Keys can be scoped, named, rotated, and revoked.
* Never place API keys in client-side browser code.
* Free plan accounts cannot create or use API keys.

## Recommended Scopes

| Scope            | Allows                                                         |
| ---------------- | -------------------------------------------------------------- |
| `usage:read`     | Read plan, credits, usage, model catalog, and pricing catalog. |
| `assets:write`   | Upload reusable assets.                                        |
| `images:read`    | Read image generation jobs.                                    |
| `images:write`   | Create image generation jobs.                                  |
| `videos:read`    | Read video generation jobs.                                    |
| `videos:write`   | Create video generation jobs.                                  |
| `voices:read`    | Read voices and voice jobs.                                    |
| `voices:write`   | Generate, clone, design, or delete voices.                     |
| `avatars:read`   | Read talking avatar jobs.                                      |
| `avatars:write`  | Create talking avatar jobs.                                    |
| `webhooks:read`  | Read webhook endpoints.                                        |
| `webhooks:write` | Manage webhook endpoints.                                      |

## Idempotency

Send `Idempotency-Key` on every job creation request. If a network retry repeats the same request, AdSkull returns the original job instead of creating a duplicate and reserving credits twice.