Skip to main content

​
Base URL

https://api-dev.qcall.ai/tts

​
Authentication

All API requests require authentication using an API key in the Authorization header: 
Authorization: Bearer your-api-key

​
Response Format

All API responses are returned in JSON format unless otherwise specified.

​
Success Response

{
  "success": true,
  "data": { ... }
}

​
Error Response

{
  "success": false,
  "error": "Error type",
  "message": "Detailed error message"
}

​
HTTP Status Codes

Status CodeDescription
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Too Many Requests
500Internal Server Error

​
Rate Limiting

API requests are rate-limited based on your subscription plan. Rate limit information is included in response headers:
  • X-RateLimit-Limit: Maximum requests allowed
  • X-RateLimit-Remaining: Remaining requests in current window
  • X-RateLimit-Reset: Time when the rate limit resets (Unix timestamp)

​
Pagination

List endpoints support pagination using query parameters:
  • page: Page number (default: 1)
  • limit: Items per page (default: 20, max: 100)
GET /voices?page=2&limit=50
Response includes pagination metadata: 
{
  "data": [...],
  "pagination": {
    "page": 2,
    "limit": 50,
    "total": 150,
    "pages": 3
  }
}

​
Endpoints Overview

​
Text-to-Speech

  • POST /tts-stream - Convert text to speech
  • POST /tts-stream (streaming) - Stream text to speech

​
Speech-to-Text

  • POST /stt - Transcribe audio to text
  • GET /stt/languages - Get supported languages

​
Voices

  • GET /voices - List all voices

​
SDKs

We provide official SDKs for popular programming languages:

JavaScript/TypeScript

npm install 60db

Python

pip install 60db