API Reference
The complete, interactive API reference is generated from the OpenAPI spec and published at:
➡️ /reference/
It documents every /voice/* endpoint with request/response schemas, parameters
and example payloads. It's rebuilt from the canonical spec on every deploy:
- Spec —
packages/vocabusta-developers/openapi/vocabusta-voice.openapi.yaml - Build —
npm run build:referencerenders it intostatic/reference/(Redocly), whichnpm run buildbundles into the site.
Point your own code generators at the OpenAPI file to produce typed clients in any language.
Endpoint summary
| Method | Path | Description |
|---|---|---|
POST | /voice/tts | Synthesize speech (WAV) |
POST | /voice/tts/stream | Streaming speech synthesis |
POST | /voice/stt | Transcribe audio |
GET | /voice/voices | List available voices |
DELETE | /voice/voices/{voice_id} | Delete a cloned voice |
POST | /voice/clone | Clone a voice from a clip |
POST | /voice/dub/analyze | Analyze a video (transcript + speakers) |
POST | /voice/dub/translate | Translate segments for dubbing |
POST | /voice/dub/render | Render a dubbed video |
GET | /voice/dub/jobs/{job_id} | Poll a dubbing job |
GET | /voice/history | List generation history |
DELETE | /voice/history/{item_id} | Delete a history item |