# Create an API key (then see the API docs)

> Make your own API key in your account, up to 10 active at once, and copy it right away: it shows only once. Create a key, then read the API docs.

URL: https://reviral.ai/docs/api-keys
Updated: 2026-10-05
Open API keys: https://reviral.ai/app/api-keys

An API key is a secret password that lets your own server or automation make videos and pictures on your Reviral account without opening the website. You create keys yourself on the **API keys** page (`/app/api-keys`); there is nothing to request. Once you have a key, everything else (requests, models, webhooks) is in the [API documentation](https://reviral.ai/docs/api).

## Steps

1. **Open API keys.** Sign in, then press **API keys** in the **Account** part of the left menu. The page is headed "API keys." and says "Create a key for your server or automation. You will see each new key only once, so copy it before leaving this page."
2. **Name the key.** Under **Create a new key** (it shows "{n}/10 active"), type a name such as "Production server". Use up to 80 letters, numbers, spaces or `. _ ( ) -`.
3. **Create it.** Press **Create key**.
4. **Copy it now.** A box says "Copy this key now. It will not be shown again." Press **Copy key** (it turns into "Copied") and store the key somewhere safe, such as your server's settings.
5. **Use it.** Keep the key on your server and send it as a Bearer token (a header your code adds to each request: `Authorization: Bearer <your key>`). Never put it in browser code. Start with the [API quickstart](https://reviral.ai/docs/api/quickstart) and [authentication](https://reviral.ai/docs/api/authentication).
6. **Revoke a key you no longer trust.** Under **Your keys**, press **Revoke** next to it. It stops working and is marked "Revoked".

## At a glance

| Item | Value |
|---|---|
| Where | **API keys**, `/app/api-keys` (signed in) |
| Who | Any signed-in account; no request needed |
| Active keys | Up to 10 |
| Key name | Up to 80 letters, numbers, spaces or . _ ( ) - |
| Shown | Once, at creation |
| Cost of a key | Free; API calls spend credits from your balance |
| Developer docs | [/docs/api](https://reviral.ai/docs/api), plus [credits and pricing](https://reviral.ai/docs/api/credits-and-pricing), [rate limits](https://reviral.ai/docs/api/rate-limits), [errors](https://reviral.ai/docs/api/errors) |

## Troubleshooting

| Message | What to do |
|---|---|
| "Enter a name for this key." | Type a name, then press **Create key**. |
| "You already have 10 active keys. Revoke one before creating another." | Revoke a key you don't use. |
| "You have created too many keys recently. Wait and try again." | Wait a while, then try again. |
| "Use up to 80 letters, numbers, spaces, or . _ ( ) - in the name." | Remove other symbols from the name. |
| "Copy failed. Select the key text above and copy it manually." | Select the key with your mouse and copy it before leaving the page. |

For anything the API docs don't answer, contact [our support team](https://reviral.ai/docs/support). See [plans and prices](https://reviral.ai/pricing) for credits.

## Related

- [Chat, tickets and contact](https://reviral.ai/docs/support)
- [How credits work](https://reviral.ai/docs/credits)
- [Find, download and share your videos](https://reviral.ai/docs/my-files)
- [Settings and brand watermark](https://reviral.ai/docs/settings)

## FAQ

### Do I need to ask for API access?

No. Any signed-in account can create keys itself on the API keys page; there is no waiting list.

### How many API keys can I have?

Up to 10 active keys. Revoke one to make room for a new one.

### I lost my key. Can I see it again?

No, a key is shown only once. Revoke the lost key and create a new one.

### What does an API call cost?

API calls spend the same credits as your account balance. See the API docs pages on credits and pricing for each model's price.