API Documentation

Everything you need to integrate Speeko into your application.

Base URL

https://api.speekoapp.com

Authentication

All API requests require a Bearer token. Pass your API key in the Authorization header.

Authorization: Bearer sk-speeko-xxxx

Endpoints

POST/ttsConvert text to speech

Parameters

textstringThe text to synthesize *

voicestringVoice ID (e.g. am_michael) *

speednumberPlayback speed, 0.5–2.0 (default: 1.0)

formatstringOutput format: mp3, wav, ogg (default: mp3)

Example Request

curl -X POST https://api.speekoapp.com/tts \ -H "Authorization: Bearer sk-speeko-xxxx" \ -H "Content-Type: application/json" \ -d '{"text": "Hello world!", "voice": "am_michael", "speed": 1.0}' \ --output output.mp3

GET/voicesList all available voices

Example Request

curl https://api.speekoapp.com/voices \ -H "Authorization: Bearer sk-speeko-xxxx"

GET/usageGet current usage and credit balance

Example Request

curl https://api.speekoapp.com/usage \ -H "Authorization: Bearer sk-speeko-xxxx"

Error Codes

400Bad Request — missing or invalid parameters

401Unauthorized — invalid or missing API key

402Payment Required — insufficient credits

429Too Many Requests — rate limit exceeded

500Internal Server Error — try again later