Developer hub

Everything you can call, one table, and the guides that use each part. Plain HTTP and JSON; no package required.

Basics

  • Base URL: https://speakvora.com/api/v1
  • Auth: header x-api-key: YOUR_KEY (or Authorization: Bearer). Keep it on a server.
  • Format: JSON in, JSON out. Speech replies carry a url to the audio.
  • Limits: 500 characters per speak request; 15 requests per second free (100 paid); 20 brand-new sentences per minute free (120 paid).
  • Clients: single-file helpers at /sdk/speakvora.js and /sdk/speakvora.py. Packages are on the way.

Endpoints

MethodPathAuthWhat it does
GET/v1/voicesnoneList voices, tiers, languages and whether each is live
GET/v1/languagesnoneLanguages with clip counts and review status
GET/v1/search?q=&lang=&limit=keySearch the checked phrase library
POST/v1/speakkeySpeak text with a catalog voice or your own cv_ voice
POST/v1/preparekeyGet up to 200 sentences ready ahead of time (not billed)
POST/v1/listenkeyTranscribe an audio file
GET/v1/packsnoneList industry packs (new packs are coming)
GET/v1/packs/{id}/downloadkeyA signed link to a purchased pack
POST/api/mcpkey for toolsMCP server: speak, list_voices, search_phrases
WebSocketsee docskey in first frameLive transcription and streamed speech

Full schema: OpenAPI · reference · llms.txt.

Guides by job

Create your first voice API key and add it to your app

From nothing to your own voice speaking inside your app: make the voice, get a key, send one request, add it to your server and switch to a library voice.

The dashboard that comes with every agent

Connect Slack, Teams, Google, texts and your own apps, approve or decline what the agent does, add your own AI key and ask for missing phrases, all by clicking, with no developer.

Connect your own phone, Telegram, WhatsApp or office phone system

Text customers from your own Android phone, answer Telegram and WhatsApp messages, and answer calls on your existing office phone system, without a Twilio account. What works, what it costs and what it cannot do.

A Twilio alternative for small business texts and calls

How a small business can text and answer customers without a Twilio account: its own Android phone, Telegram, WhatsApp and an existing phone system. What works, what it costs and what still needs Twilio.

Text customers from your own Android phone with automatic replies

Use the free SMS Gateway app and the Speakvora agent so customers text your normal number and get an automatic answer from the same phone. Setup in about 15 minutes, with the limits stated.

A Telegram bot for small business that answers customers

Make a free Telegram bot and let the Speakvora agent answer customer messages with your hours, status and hand-off. Five minutes, no public web address, text only.

WhatsApp auto-reply for a small business, without Twilio

Connect WhatsApp through Meta's own Cloud API and let the Speakvora agent answer customer messages. What the setup involves, what it costs and what is not built yet.

Answer business calls on your existing phone system, no Twilio

The Speakvora agent signs in to your phone system as a SIP extension, answers the calls you send to it, plays your menu and transfers to staff. Tested with Asterisk, with the limits stated.

Start your voice agent in five minutes

Unzip your agent, double-click Start Speakvora Agent, and your dashboard opens in the browser in practice mode. No terminal and no developer; it needs Python 3.9 or newer (free).

Test your voice agent before it talks to a customer

Test my agent shows the exact reply and every action your voice agent would take for a customer text or an event in your app, with nothing sent.

Build a phone menu: press 1 for hours, 3 for billing

Build your own phone menu in the dashboard: choose what each key does, connect a person or department, let callers say what they need, and test it by pretending to call.

Build your own voice agent workflows, no code

Make your own when-this-happens, do-this workflows: a customer texts a word, something happens in your app, a booking is coming up, or a time of day. Reply, text, tell your team or email.

Let your own AI answer customer texts and calls

Connect your own Claude or ChatGPT key and your voice agent answers real customer questions from your business details, documents and menu, hands a person over when needed, and never invents prices.

Run several business locations from one dashboard

A commercial licence adds a Locations button to the dashboard: switch between your branches in one click, see which need you, and set each one up with its own business details.

Add speech to a web app

A server route that speaks text and a page that plays it, without exposing your API key.

Combine reusable phrases with live speech

Search the library first, speak a library line instantly, and fall back to live generation for everything else.

Use your own voice through the API

Create a voice in the portal, wait until it is ready, and speak with its cv_ id.

Transcribe an audio file with the API

Send a recording as base64, get text and the billed seconds back, and handle the size limit and errors.

Stream live transcription over a WebSocket

Authenticate, stream 16 kHz PCM audio in short frames, and read final text shortly after speech stops.

Connect the Speakvora MCP server to Claude Code and Cursor

Add the remote server, pass your key as a header, and let an assistant speak text and search the phrase library.

Handle errors, retries and rate limits

Every error has a code and a fix. Which to retry, how long to wait, and a retry helper that respects retry_after_seconds.

Store and reuse generated audio without paying twice

Which links last, which expire, and a pattern that fetches an audio link once and serves your own copy.

Use your own voice in your apps

Make the voice once in the portal, then speak with it from a web app, a mobile app or a kiosk without exposing your key.

Speak text in a Next.js app with a route handler

A server route handler that calls the speech API with your key, plus a client button that plays the returned link.

Add a speech endpoint to a FastAPI service

A FastAPI route that validates text, calls the speech API and returns the audio link, with the errors mapped to useful status codes.

Prepare prompts ahead of time so they play instantly

Send up to 200 sentences per call to /v1/prepare, then speak them later without waiting for generation.

Test your speech integration without spending quota

Mock the API in unit tests, and run one tiny live smoke test that reads the key from the environment and never prints it.

Understand the product

How generation works · How billing counts usage · Your own voice · Speech to text · Speed · Status

Quick answers

How much is free?

Every account gets 100,000 characters of speech free every month, with no credit card, plus 60 minutes of speech to text every month. Both renew on the 1st of every month (UTC).

How fast is Speakvora text to speech?

Measured on our own Mac mini on 2026-11-21: first audio in about 44 ms with Phonon voices and 90 ms with Pocket voices (measured 2026-11-21 with the client in AWS us-east-1; your own network adds its own delay).

What does it cost after the free allowance?

Text to speech is $3 per million characters and speech to text is $0.0015 per minute. Industry agents are a one-time payment from $214 with no per-call, per-text or per-minute fee from Speakvora.

Are the voices human?

No. They are AI voices chosen by ear to sound natural; you can listen to each one before you buy.