API Reference - Destined Voice API

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

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

Pagination

List endpoints support pagination:

GET /v1/speakers?limit=20&offset=40

Parameter	Type	Default	Description
`limit`	integer	20	Items per page (max 100)
`offset`	integer	0	Number of items to skip

Response includes pagination metadata:

{
  "items": [...],
  "total": 2400,
  "limit": 20,
  "offset": 40,
  "has_more": true
}

Rate Limits

Tier	Requests/min	Requests/day
Starter	60	1,000
Pro	300	10,000
Enterprise	1,000	Unlimited

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

​Base URL

​Authentication

​Response Format

​Error Format

​Status Codes

​Pagination

​Rate Limits

​Endpoint Groups