Authentication

Overview

Destined Voice API uses Bearer token authentication. Include your API key in the Authorization header of every request.

Getting Your API Key

Sign up at destined.ai
Navigate to Settings > API Keys
Click Create API Key
Copy and store your key securely

Keep your API key secret. Never commit it to version control or expose it in client-side code.

Using the API Key

With the SDK

import { SDK } from "@destined-ai/voice";

const client = new SDK({
  bearerToken: process.env.DESTINED_API_KEY,
});

With cURL

curl -X GET "https://api.destined.ai/v1/speakers" \
  -H "Authorization: Bearer YOUR_API_KEY"

With fetch

const response = await fetch("https://api.destined.ai/v1/speakers", {
  headers: {
    "Authorization": `Bearer ${process.env.DESTINED_API_KEY}`,
    "Content-Type": "application/json",
  },
});

Public Endpoints

Some endpoints don’t require authentication:

Endpoint	Description
`GET /health`	API health check
`GET /v1/speakers`	List available speakers

Error Responses

Authentication errors return a 401 Unauthorized response:

{
  "detail": "Invalid or expired API key"
}

Common authentication issues:

Error	Cause	Solution
`401 Unauthorized`	Missing or invalid API key	Check your API key is correct
`403 Forbidden`	Insufficient permissions	Contact support
`429 Too Many Requests`	Rate limit exceeded	Wait and retry

Quickstart Speakers

Get Started

Core Concepts

SDKs

Overview

Getting Your API Key

Using the API Key

With the SDK

With cURL

With fetch

Public Endpoints

Error Responses

​Overview

​Getting Your API Key

​Using the API Key

​With the SDK

​With cURL

​With fetch

​Public Endpoints

​Error Responses

Overview

Getting Your API Key

Using the API Key

With the SDK

With cURL

With fetch

Public Endpoints

Error Responses