Quickstart
From sign-up to your first transcribe call in under five minutes.
Using Claude Code, Codex, OpenCode, Cursor, or another AI coding tool? Start by connecting Speko MCP.
1. Create an account and an API key
Sign up at platform.speko.dev, then open API keys and click Create key. Copy the raw value - it is shown once and starts with sk_live_.
export SPEKO_API_KEY=sk_live_xxx2. Configure providers (optional)
Speko uses platform-managed provider credentials by default. To bring your own keys (BYOK), open Settings > Provider keys and paste each provider's API key. Speko still picks the best provider per call; your keys are billed by the provider directly. See BYOK.
3. Make your first call
curl -X POST https://api.speko.dev/v1/transcribe \
-H "Authorization: Bearer $SPEKO_API_KEY" \
-H "Content-Type: audio/wav" \
-H "x-speko-intent: {\"language\":\"en-US\"}" \
--data-binary @call.wavimport { Speko } from '@spekoai/sdk';
import { readFile } from 'node:fs/promises';
const speko = new Speko({ apiKey: process.env.SPEKO_API_KEY! });
const audio = await readFile('./call.wav');
const { text, provider, model, confidence } = await speko.transcribe(audio, {
language: 'en-US',
});
console.log(text, 'from', provider, model, confidence);import os
from pathlib import Path
from spekoai import Speko
speko = Speko(api_key=os.environ["SPEKO_API_KEY"])
audio = Path("call.wav").read_bytes()
result = speko.transcribe(audio, language="en-US")
print(result.text, "from", result.provider, result.model, result.confidence)The response includes provider, model, confidence, and failoverCount so you can see what actually ran. Routing headers are also returned: X-Speko-Provider, X-Speko-Model, X-Speko-Failover-Count, X-Speko-Scores-Run-Id.
4. Pick your next path
Connect Speko MCP
Let your AI coding tool search docs, scaffold integrations, and use account tools.
Add voice to a browser app
@spekoai/client over WebRTC.
Use a framework adapter
Connect Speko to a self-hosted LiveKit worker.
Use the one-shot APIs
/v1/transcribe, /v1/synthesize, /v1/complete for batch and server flows.
5. Or let your coding agent build it
The fastest path to a working voice agent is to hand the rest to your AI coding tool. Install Speko MCP:
npx @spekoai/mcp@latest initThen paste this prompt into your agent:
Using the Speko MCP tools, build me a voice agent:
1. Search the Speko docs for current voice agent best practices.
2. Create an agent named "my-first-agent" with a friendly assistant
system prompt and the recommended STT, LLM, and TTS for my language.
3. Deploy it and start a test session so I can talk to it.
4. Scaffold a minimal web app that connects to it with @spekoai/client.The agent uses Speko MCP to create, deploy, and test the voice agent against your account, then wires up a local app you can run immediately.