Developer Reference

Complete API Reference for Speech AI Integration

Explore the complete Raritone API Reference to integrate AI Voice Generation, Text-to-Speech, Speech-to-Text, and Voice Cloning into your applications using secure REST APIs.

Get API Key View Documentation

Trusted by 10,000+ developersSOC 2 Type II · 99.99% uptime

RESTJSONWebhooksv1.4.2

raritone-api.sh

POSThttps://api.raritone.com/v1/voice/generate

1curl -X POST https://api.raritone.com/v1/voice/generate \

2 -H "Authorization: Bearer $RARITONE_API_KEY" \

3 -H "Content-Type: application/json" \

4 -d '{

5 "voice_id": "aurora-v3",

6 "text": "Welcome to Raritone Speech AI.",

7 "format": "mp3_44100"

8 }'

Response

200 OK · 0.34s

Overview

Everything You Need to Build with the Raritone API

The API Reference provides detailed information about available endpoints, authentication, request parameters, response formats, and error handling. Whether you're building a simple integration or an enterprise-scale application, you'll find the technical resources needed to get started.

Reference v1.4 · Updated dailyLive

12

Endpoints

v1.4

Version

99.99%

Uptime

API · v1.4Open docs

raritone · developer reference

Live

blueprint · rev 1.4

Authentication

Secure every request with your API Key

Secure every request using your personal API Key.

API Key Authentication
Required
Bearer token included in every request header.
HTTPS Encryption
Required
All traffic is TLS 1.3 with PFS by default.
Secure Access Tokens
Required
Short-lived tokens with scoped permissions.
Request Validation
Required
Signed requests verified on the server side.

Credentials

Live environment

Active

Base URLHTTPS

https://api.raritone.com/v1

API KeyMasked

rk_live_·····················xQ72f9aD

Last rotated · 14 days ago

Encrypted at rest & in transit

Available Endpoints

Six endpoints, one platform.

Mix and match to power any voice or speech feature.

Open docs

Endpoint 01

Voice Generation API

POST/voice/generatev1 · ~310ms

Generate natural AI voices from text input.

Paramstextvoice_idformat

sample.json

200 OK

{
  "text": "Welcome to Raritone",
  "voice_id": "aria",
  "format": "mp3"
}

Open docs

Endpoint 02

Text-to-Speech API

POST/text-to-speechv1 · ~420ms

Convert text into downloadable speech.

Paramstextlanguagespeed

sample.json

200 OK

{
  "text": "Hello world",
  "language": "en-US",
  "speed": 1.0
}

Open docs

Endpoint 03

Speech-to-Text API

POST/speech-to-textv1 · ~620ms

Upload audio and receive AI-generated transcripts.

Paramsaudio_urllanguagespeakers

sample.json

200 OK

{
  "audio_url": "https://files/m.mp3",
  "language": "en-US",
  "speakers": true
}

Open docs

Endpoint 04

Voice Cloning API

POST/voice-cloningv1 · ~2.4s

Create and manage authorized custom voice profiles.

Paramsnamesamplesconsent

sample.json

200 OK

{
  "name": "studio_v1",
  "samples": ["s1.wav", "s2.wav"],
  "consent": true
}

Open docs

Endpoint 05

Voice Library API

GET/voicesv1 · ~95ms

Retrieve available AI voices, languages, and voice profiles.

Params?language?gender?style

sample.txt

200 OK

// GET /v1/voices?language=en-US
// returns Array<Voice>

Open docs

Endpoint 06

Account API

GET/accountv1 · ~80ms

View account information, API usage, and subscription details.

Params?include

sample.txt

200 OK

// GET /v1/account
// returns { plan, usage, limits }

Response Format

Predictable, JSON-first responses.

All API responses are returned in standard JSON format.

response.json

200 OK

1{
2  "status": "success",
3  "request_id": "req_123456789",
4  "message": "Voice generated successfully"
5}

Top-level fields

statusstring

success | error indicator.

request_idstring

Unique identifier for tracing requests.

messagestring

Human-readable description of the result.

dataobject

Endpoint-specific payload (when present).

Status Codes

Standard HTTP status codes

Use these codes to handle responses gracefully in your application.

Status Board

Updated · v1.4

Code

Description

Type

SUCCESS
200
Request successful
SUCCESS
201
Resource created
SUCCESS
CLIENT ERROR
400
Invalid request
CLIENT ERROR
401
Authentication failed
CLIENT ERROR
403
Access denied
CLIENT ERROR
404
Resource not found
CLIENT ERROR
429
Rate limit exceeded
CLIENT ERROR
SERVER ERROR
500
Internal server error
SERVER ERROR

8 codes · 3 groupsLive reference

Rate Limits

Quota that scales with your plan

API request limits depend on your subscription plan. Higher-tier plans include larger request quotas and priority processing.

Free

Plan 01

1,000

req/day

RPM5

Community priority

Starter

Plan 02

25,000

req/day

RPM30

Standard priority

Professional

Plan 03

250,000

req/day

RPM120

High priority

Business

Plan 04

1M

req/day

RPM500

Highest priority

TIER 05

Enterprise

Plan 05

Unlimited

requests

RPMCustom

Dedicated priority

Need more?Contact sales for custom limits.Contact sales

Best Practices

Build with confidence

Recommendations to keep your integration secure, reliable, and easy to maintain.

Best practices applied6/6

Hardened100%

01

Do this

Practice 01

Secure Key Storage

Store API keys securely. Never commit them to source control.

02

Do this

Practice 02

HTTPS Always

Always use HTTPS. We do not accept plaintext HTTP traffic.

03

Do this

Practice 03

Input Validation

Validate user input before making requests.

04

Do this

Practice 04

Error Handling

Handle API errors gracefully with clear user feedback.

05

Do this

Practice 05

Retry Logic

Implement retry with exponential back-off for temporary failures.

06

Do this

Practice 06

Usage Monitoring

Monitor usage through your dashboard and set alerts.

SDK & Integration

Use any language, ship anywhere

Raritone APIs can be integrated with any programming language that supports HTTPS requests. Popular environments include:

Supported environments · 8 of many

Python

PY

$pip install raritone

$composer require raritone/sdk

$dotnet add package Raritone

Open SDK docs

Ruby

RB

$gem install raritone

Open SDK docs

Don't see yours? All endpoints work with any HTTPS-capable runtime.

Frequently Asked

API questions, answered

Quick answers to the most common questions developers ask while integrating with the Raritone API.

FAQ · 05 · Updated monthly

Raritone

Reply < 5m

— The developer success team

Talk to engineering

Create a Raritone account, sign in to your dashboard, and generate an API key from the developer settings.

Live engineers online

Still stuck on integration?

Hop into a dedicated developer chat with our engineering team for hands-on help with auth, payloads, or webhooks.

Open developer chat Read the docsAvg. reply < 5 min

Ready to ship

Start Building with the Raritone API

Access secure APIs, detailed technical documentation, and scalable speech AI services to power your applications.

12 endpoints99.99% uptime180+ languages

Get API Key Start Free

{ curl -X POST api.raritone.com/v1 }

ARJLMKSP

Trusted by 10,000+ developers

4.9/ 5Docs ready

Complete API Reference for Speech AI Integration

Everything You Need to Build with the Raritone API

Secure every request with your API Key

API Key Authentication

HTTPS Encryption

Secure Access Tokens

Request Validation

Six endpoints, one platform.

Voice Generation API

Text-to-Speech API

Speech-to-Text API

Voice Cloning API

Voice Library API

Account API

Predictable, JSON-first responses.

Standard HTTP status codes

Quota that scales with your plan

Free

Starter

Professional

Business

Enterprise

Build with confidence

Secure Key Storage

HTTPS Always

Input Validation

Error Handling

Retry Logic

Usage Monitoring

Use any language, ship anywhere

API questions, answered

How do I obtain an API key?

Is authentication required?

What format are responses returned in?

Are SDKs available?

Where can I report API issues?

Still stuck on integration?

Start Building with the Raritone API