Developer Documentation

Everything You Need to Build with Raritone

Explore comprehensive documentation for integrating AI voice generation, text-to-speech, speech-to-text, and voice cloning into your applications. From quick start guides to API references, Raritone provides the resources developers need to build with confidence.

REST

API Surface

6+

SDKs

24/7

Status Page

Updated weekly·Versioned changelog
Raritone documentation workspace
Docs · Live

Product

Voice API

+6
4.9

Loved by 10,000+ developers

POST · Endpoint
/v1/voice
p95 Latency
218ms

Try it

Interactive playground

Run
Documentation Overview#overview

Build Faster with Clear Developer Guides

Raritone documentation is designed to help developers integrate Speech AI capabilities quickly and efficiently. Whether you're making your first API request or deploying enterprise applications, you'll find practical guides, code examples, and technical references in one place.

API Surface
REST
SDKs
6+
Status Page
24/7
Quick Start#quickstart

From signup to first call

Five steps to integrate the Raritone API end-to-end.

  1. STEP 01↓ next

    Create a Raritone account

    Sign up in under a minute. No credit card required.

  2. STEP 02↓ next

    Generate your API key

    Provision keys from the dashboard with scoped permissions.

  3. STEP 03↓ next

    Review authentication

    Learn how requests are signed and how to secure secrets.

  4. STEP 04↓ next

    Make your first request

    Hit the synthesis endpoint and receive audio in ms.

  5. STEP 05

    Integrate into your app

    Ship to production with SDKs, webhooks, and streaming.

Documentation Sections#sections

Find what you need, fast

Every guide is organized to match the way developers actually build—pick a section and jump in.

API Guides#api-guides

Every capability, one reference

Dedicated guides for every endpoint—complete with parameters, response shapes, and working code.

Best Practices#best-practices

Ship reliable, scalable voice apps

Build reliable and scalable applications by following recommended implementation guidelines.

Secure API Key Management

Store keys in env vars or a secrets manager—never commit them.

Request Validation

Validate payloads on the client and server to catch mistakes early.

Error Handling

Map error codes to user-facing messages and structured logs.

Rate Limit Management

Throttle requests, batch where possible, and respect retry headers.

Performance Optimization

Stream audio, cache responses, and choose the right model tier.

Retry Strategies

Use exponential backoff with jitter on 429s and 5xx responses.

Logging & Monitoring

Track latency, error rate, and cost per call with structured logs.

Production Deployment

Provision regional endpoints and enable failover.

Developer Resources#resources

Bookmark these

The handful of links you'll keep coming back to while you build.

Common Error Codes#errors

Decode any non-200 response

Every error code, what it means, and how to recover.

CodeDescriptionType
400

Bad Request

Invalid request parameters.

Client
401

Unauthorized

Authentication failed.

Client
403

Forbidden

Access denied.

Client
404

Not Found

Resource not found.

Client
429

Too Many Requests

Rate limit exceeded.

Client
500

Server Error

Internal server error.

Server
Every error response includes error_code and message fields.
Frequently Asked Questions#faq

Answers, before you ask

Create a Raritone account, generate an API key, and follow the Quick Start guide to make your first request in minutes.
Have another question? Reach the Help Center
Start Building

Start Building with Raritone Docs

Access developer guides, API references, and practical examples to integrate AI voice capabilities into your applications.

No credit card requiredInteractive playgroundFree tier included

Time to first call

< 60 seconds

quickstart.ts
copy
1import { Raritone } from "raritone"
2
3const client = new Raritone({
4apiKey: process.env.RARITONE_KEY,
5})
6
7await client.voice.generate({
8text: "Hello, world."
9})
200 OKaudio/mpeg · 142kb

Latency

p95 218ms