API Documentation

Integrate natural text-to-speech into your applications with our simple REST API

Get Free API KeyTry Playground

Base URL

https://voicenom.com/api/v1

Quick Start

1

Create Account

Sign up free and get 1,000 units instantly

2

Get API Key

Generate your key in Dashboard → API Keys

3

Make Request

Send text, receive audio. It's that simple!

Authentication

All API requests require authentication. Include your API key in theX-API-Keyheader with every request.

X-API-Key: vn_your_api_key_here

Keep your API key secure! Never expose it in client-side code or public repositories.

API Endpoints

POST/v1/synthesize

Convert text to natural-sounding speech audio

Request Body (JSON)

ParameterTypeRequiredDescription
textstringYesText to convert (max 10,000 characters)
voicestringNoVoice ID (default: en-US-AriaNeural)
ratestringNoSpeaking rate: "-50%" to "+100%" (default: "+0%")
pitchstringNoVoice pitch: "-50Hz" to "+50Hz" (default: "+0Hz")
volumestringNoVolume: "-50%" to "+50%" (default: "+0%")

Response

Returns an MP3 audio file with Content-Type: audio/mpeg

200Success - returns audio file (MP3)
400Bad request - invalid parameters
401Unauthorized - invalid or missing API key
402Payment required - insufficient units
403Forbidden - feature not available for your plan
429Rate limit exceeded - too many requests
500Server error - please try again
GET/voices

Get list of all available voices (no authentication required)

Returns a JSON object with voices organized by gender and region.

This endpoint is public and doesn't require an API key.

GET/pricing

Get current pricing tiers (no authentication required)

Returns an array of pricing tier objects with name, units, and price information.

Code Examples

curl -X POST "https://voicenom.com/api/v1/synthesize" \
  -H "X-API-Key: vn_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello! Welcome to VoiceNom.",
    "voice": "en-US-AriaNeural",
    "rate": "+0%",
    "pitch": "+0Hz"
  }' \
  --output speech.mp3

Popular Voices

Voice IDNameLanguageGenderStyle
en-US-AriaNeuralAriaEnglish (US)FemaleMost Natural
en-US-GuyNeuralGuyEnglish (US)MaleProfessional
en-US-JennyNeuralJennyEnglish (US)FemaleConversational
en-US-AvaMultilingualNeuralAvaEnglish (US)FemaleMultilingual
en-US-AndrewMultilingualNeuralAndrewEnglish (US)MaleMultilingual
en-GB-SoniaNeuralSoniaEnglish (UK)FemaleElegant
en-GB-RyanNeuralRyanEnglish (UK)MaleProfessional
en-AU-NatashaNeuralNatashaEnglish (AU)FemaleWarm
es-ES-ElviraNeuralElviraSpanishFemaleNatural
fr-FR-DeniseNeuralDeniseFrenchFemaleNatural
de-DE-KatjaNeuralKatjaGermanFemaleNatural
ja-JP-NanamiNeuralNanamiJapaneseFemaleNatural

50+ voices available. Use /voices endpoint for the complete list.

Voice CloningPaid Feature

Create custom voice clones from audio samples. This premium feature is available for users who have made at least one purchase.

Endpoints

  • POST/voice-clones
  • GET/voice-clones
  • POST/voice-clones/:id/samples
  • POST/voice-clones/:id/train
  • POST/synthesize-clone

Requirements

  • At least one unit purchase required
  • Upload 1-10 audio samples (MP3/WAV)
  • Maximum 5 voice clones per account
  • Clone synthesis costs 20% more units

Pricing & Usage

How Billing Works

VoiceNom uses a simple unit-based billing system. 1 unit = 1 character (excluding whitespace).

  • Units are deducted per request
  • Units never expire
  • No monthly subscriptions

Current Pricing

Free1,000 units
Starter ($9)25,000 units
Pro ($29)100,000 units
Business ($99)500,000 units
View full pricing →

Rate Limits

API requests are rate-limited to ensure fair usage and service stability.

100
requests per minute
10,000
max characters per request
5
API keys per account

Rate limit headers are included in every response:X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset

Need higher limits? Contact support@voicenom.com for enterprise plans.

Need Help?

Our team is here to help you integrate VoiceNom into your application.

Email SupportTry the Playground