Skip to main content
The VoiceDub API provides programmatic access to AI voice dubbing and custom voice training capabilities. Transform any audio with 10,000+ voices or train your own voice models.

​
Base URL

All API requests should be made to: 
https://api.voicedub.ai

​
Authentication

The API uses API key authentication. Include your API key in the Authorization header: 
Authorization: Api-Key YOUR_API_KEY
Get your API key from the API Keys Dashboard.

​
Request Format

  • Content-Type: application/json for all POST/PATCH requests
  • Accept: application/json for all responses
  • Encoding: UTF-8

​
Query Parameters

For array query parameters, the API supports multiple syntax formats: 
# Repeated parameter names (more widely supported by HTTP clients)
?param=value1&param=value2&param=value3

# Array notation with brackets
?param[]=value1&param[]=value2&param[]=value3

# Indexed array notation
?param[0]=value1&param[1]=value2&param[2]=value3

# Comma-separated values (not recommended since a comma could appear in a value, but easier for testing)
?param=value1,value2,value3
Example usage: 
# Filter voices by multiple genres
GET /v1/voices?genres=pop&genres=rap&genres=rock
GET /v1/voices?genres[]=pop&genres[]=rap&genres[]=rock
GET /v1/voices?genres[0]=pop&genres[1]=rap&genres[2]=rock
GET /v1/voices?genres=pop,rap,rock

​
Response Format

All API responses return JSON with consistent structure:

​
Success Responses

{
  "user": {
    "apiCredits": 1000
  }
}

​
Error Response Examples

400 Bad Request: 
{
  "code": "invalid_arguments",
  "message": "Invalid request parameters or body",
  "errors": {
    "params": "...",
    "query": "...",
    "body": "..."
  }
}
401 Unauthorized: 
{
  "code": "unauthorized",
  "message": "You are not authorized to perform this action"
}
403 Insufficient Credits: 
{
  "code": "not_enough_credits", 
  "message": "Looks like you don't have enough credits! Purchase more at https://voicedub.ai/developer/billing"
}
404 Not Found: 
{
  "code": "not_found",
  "message": "Dub not found"
}
429 Rate Limited: 
{
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please wait before making more requests."
}

​
HTTP Status Codes

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

​
Endpoints Overview

​
User Management

  • GET /v1/me - Get account information and credit balance

​
Voice Dubbing

  • GET /v1/me/dubs/{dubId} - Get dub details and status
  • POST /v1/me/dubs - Create a new voice dub
  • POST /v1/me/dubs/{dubId}/preprocess - Start dub preprocessing
  • POST /v1/me/dubs/{dubId}/generate - Start dub generation

​
Voice Models

  • GET /v1/voices - List public voices with filtering
  • GET /v1/me/voices/{voiceId} - Get custom voice details
  • POST /v1/me/voices - Create a custom voice for training
  • POST /v1/me/voices/{voiceId}/clone - Start voice training

​
Pagination

List endpoints support cursor-based pagination:
​
limit
integer
default:50
Number of items to return (8-50)
​
cursor
string
Pagination cursor for next page (from previous response)
Paginated Response: 
{
  "voices": [...],
  "nextCursor": "2_123e4567-e89b-12d3-a456-426614174001"
}

​
Webhooks

Webhooks are not currently supported. Use polling to check job status:
  • Dubs: Poll /v1/me/dubs/{dubId} maximum once every 3 seconds
  • Voices: Poll /v1/me/voices/{voiceId} maximum once every 3 seconds

​
Rate Limits

The API enforces different rate limits based on the type of operation:

​
Read Operations (GET requests)

  • 10,000 requests per minute
  • Includes polling endpoints like checking dub/voice status

​
Write Operations (POST, PATCH, DELETE requests)

  • 500 requests per minute
  • 20,000 requests per hour
  • Includes creating dubs, starting processing, voice training, etc.

​
Global Limit

  • 15,000 requests per minute (across all endpoints)
When you exceed rate limits, you’ll receive a 429 Too Many Requests response with retry information in the headers.
For detailed rate limiting behavior and best practices, see our Rate Limits Guide.

​
SDKs and Libraries

Official SDKs are not yet available. For now, use standard HTTP libraries:

Node.js

Use fetch() or axios for HTTP requests

Python

Use requests, aiohttp, or httpx libraries for HTTP requests

cURL

Use cURL for command-line testing

Postman

Import our OpenAPI spec for testing

Custom SDK

Generate your own SDK using our OpenAPI spec

​
Testing

Use these test resources for development:

​
Test Audio URLs

  • Moments: https://www.youtube.com/watch?v=14CjyUYO8lE

​
Test Voice IDs

Search for these popular voices:
  • Character voices: Search “plankton”, “spongebob”
  • Music voices: Search by genre ?genres=pop,rap
  • Language-specific: Search by language ?languages=english,spanish

​
Support

Ready to start building? Check out our Quick Start Guide or dive into the endpoint documentation below.