Examples
Concrete calls you can copy, paste, and hand to your own AI to wire up an integration.
At a glance
- Discover engines.
- Synthesize inline and queued.
- Poll and download audio.
Discover engines
curl -H "Authorization: Bearer $KEY" \
http://127.0.0.1:8123/api/v1/tts/engines
Synthesize
curl -X POST http://127.0.0.1:8123/api/v1/tts/synthesize \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Chapter one.", "voice": "gravel-road"}'
Poll & download (long text)
# returns {"job_id":"abc","poll":"/api/v1/tts/jobs/abc"}
curl -H "Authorization: Bearer $KEY" http://127.0.0.1:8123/api/v1/tts/jobs/abc
curl -H "Authorization: Bearer $KEY" -o out.wav \
http://127.0.0.1:8123/api/v1/tts/jobs/abc/audio