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(orAuthorization: Bearer). Keep it on a server. - Format: JSON in, JSON out. Speech replies carry a
urlto 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
| Method | Path | Auth | What it does |
|---|---|---|---|
| GET | /v1/voices | none | List voices, tiers, languages and whether each is live |
| GET | /v1/languages | none | Languages with clip counts and review status |
| GET | /v1/search?q=&lang=&limit= | key | Search the checked phrase library |
| POST | /v1/speak | key | Speak text with a catalog voice or your own cv_ voice |
| POST | /v1/prepare | key | Get up to 200 sentences ready ahead of time (not billed) |
| POST | /v1/listen | key | Transcribe an audio file |
| GET | /v1/packs | none | List industry packs (new packs are coming) |
| GET | /v1/packs/{id}/download | key | A signed link to a purchased pack |
| POST | /api/mcp | key for tools | MCP server: speak, list_voices, search_phrases |
| WebSocket | see docs | key in first frame | Live 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.