Skip to main content

​
Base URL

https://api.destined.ai

​
Authentication

Most endpoints require Bearer token authentication: 
Authorization: Bearer YOUR_API_KEY

​
Response Format

All responses are JSON with this structure: 
{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

​
Error Format

{
  "detail": "Error message here",
  "status_code": 400,
  "request_id": "req_abc123"
}

​
Status Codes

CodeDescription
200Success
201Created
400Bad Request - Invalid parameters
401Unauthorized - Invalid/missing API key
403Forbidden - Insufficient permissions
404Not Found - Resource doesn’t exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Pagination

List endpoints support pagination: 
GET /v1/speakers?limit=20&offset=40
ParameterTypeDefaultDescription
limitinteger20Items per page (max 100)
offsetinteger0Number of items to skip
Response includes pagination metadata: 
{
  "items": [...],
  "total": 2400,
  "limit": 20,
  "offset": 40,
  "has_more": true
}

​
Rate Limits

TierRequests/minRequests/day
Starter601,000
Pro30010,000
Enterprise1,000Unlimited
Rate limit headers in every response: 
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1705312260

​
Endpoint Groups

Health

API status and health checks

Speakers

Browse 2,400+ speaker voices

TTS Generation

Generate speech from text

Jobs

Track batch processing jobs

STT Testing

Evaluate STT providers

Datasets

Import CSV for bulk generation

Users

Profile and usage info

Billing

Subscription management