Authentication - Beeble API Documentation

Getting Your API Key

  1. Go to Developer Page
    Go to developer.beeble.ai/api-keys.

  2. Sign Up
    Sign up and accept the terms if you don’t have an account.

  3. Create Key
    Click Create Key to generate a new key.

  4. Save Your Key
    Copy and securely store your API key immediately. For security reasons, you won’t be able to view it again.

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.

Using Your API Key

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

cURL

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

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

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" }),
});

Revoking Your API Key

If you need to revoke your API key:

  1. Go to the Developer Page
  2. Click the Revoke button next to your API key
  3. Confirm the revocation

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