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

# Authentication

> How to obtain and use your Beeble API key

The Beeble API uses API keys for authentication. Each request must include your API key in the request headers.

## Getting Your API Key

<Steps>
  <Step title="Go to Developer Page">
    Go to [developer.beeble.ai/api-keys](https://developer.beeble.ai/api-keys).
  </Step>

  <Step title="Sign Up">
    Sign up and accept the terms if you don't have an account.
  </Step>

  <Step title="Create Key">
    Click **Create Key** to generate a new
    key.
  </Step>

  <Step title="Save Your Key">
    Copy and securely store your API key immediately. For security reasons,
    you won't be able to view it again.
  </Step>
</Steps>

<Warning>
  Your API key will only be displayed once upon creation. Make sure to
  copy and store it in a secure location before closing the dialog.
</Warning>

## Using Your API Key

Include your API key in the `x-api-key` header with every request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.beeble.ai/v1/uploads \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"filename": "source.mp4"}'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.beeble.ai/v1/uploads",
      headers={
          "x-api-key": "YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={"filename": "source.mp4"}
  )
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.beeble.ai/v1/uploads", {
      method: "POST",
      headers: {
          "x-api-key": "YOUR_API_KEY",
          "Content-Type": "application/json",
      },
      body: JSON.stringify({ filename: "source.mp4" }),
  });
  ```
</CodeGroup>

## Revoking Your API Key

If you need to revoke your API key:

1. Go to the [Developer Page](https://developer.beeble.ai/api-keys)
2. Click the **Revoke** button next to your API key
3. Confirm the revocation

<Note>
  After revoking your API key, all requests using that key will be rejected.
  You can issue a new key at any time.
</Note>