Skip to main content

Authentication

All requests to the Uberduck API require authentication using API keys. This page explains how to obtain and use your API keys.

Obtaining API Keys​

API keys can be obtained from your Uberduck account dashboard:

  1. Sign in to your account at uberduck.ai
  2. Navigate to the API section in your account settings
  3. Click "Generate API Key"

Each API key has specific permissions and rate limits based on your subscription tier.

Using API Keys​

Include your API key in the Authorization header of all requests:

Authorization: Bearer YOUR_API_KEY

Example Request with Authentication​

curl -X POST https://api.uberduck.ai/v1/text-to-speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, world!",
    "voice": "aws-polly-joanna",
    "model": "polly_neural"
  }'

API Key Security​

Keep your API key secure:

  • Never expose your API key in client-side code
  • Don't share your API key with others
  • Regenerate your API key if you suspect it has been compromised
  • Use environment variables to store API keys in your applications

Rate Limits​

API requests are subject to rate limiting based on your subscription tier. See Rate Limits for details.

Permissions​

Each API key has a set of permissions that determine which API endpoints can be accessed. The permissions are based on your subscription tier and any custom settings applied to your account.