{"info":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","description":"

Public REST API for SonexLabs Text-to-Speech (Panini engine). Environment: Platform Testing. See the accompanying Platform API Guide for formatting conventions, rate limits, and error handling. Pre-production/peak-load testing is a separate environment handled with your SonexLabs SPOC.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"57190947","collectionId":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","publishedId":"2sBY4VKd9c","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-08-06T21:52:55.000Z"},"item":[{"name":"Text to Speech","item":[{"name":"POST /speech — Synthesize (full audio)","id":"9893900f-d588-4f28-91cd-6d46f350f22d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"Your premium of rupees twelve thousand five hundred is due on the fifteenth of September.\",\n \"voice_id\": \"REPLACE_WITH_VOICE_ID\",\n \"language\": \"auto\",\n \"speed\": 1.0,\n \"output_format\": \"wav\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.sonexlabs.com/v1/speech","description":"

Returns the complete audio file in one response. Body fields:

\n\n

Response: binary audio, Content-Type matches output_format, X-Chars-Billed header.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}},"urlObject":{"path":["speech"],"host":["https://api.sonexlabs.com/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"9893900f-d588-4f28-91cd-6d46f350f22d"},{"name":"POST /speech/stream — Synthesize (streaming)","id":"c0448887-1508-444f-9a44-23973a6a23d0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"text\": \"Your premium of rupees twelve thousand five hundred is due on the fifteenth of September.\",\n \"voice_id\": \"REPLACE_WITH_VOICE_ID\",\n \"language\": \"auto\",\n \"speed\": 1.0\n}","options":{"raw":{"language":"json"}}},"url":"https://api.sonexlabs.com/v1/speech/stream","description":"

Same request body as /speech. Streams audio back as chunked HTTP, sentence-by-sentence, for lower perceived latency on longer scripts.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}},"urlObject":{"path":["speech","stream"],"host":["https://api.sonexlabs.com/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"c0448887-1508-444f-9a44-23973a6a23d0"}],"id":"4cbf9be5-8d8f-49d0-88a0-7af0c271ea6f","_postman_id":"4cbf9be5-8d8f-49d0-88a0-7af0c271ea6f","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}}},{"name":"Voices","item":[{"name":"GET /voices — List voices","id":"cf67e1af-fc22-4389-ad93-a58183bf4029","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.sonexlabs.com/v1/voices","description":"

Returns platform preset voices plus any voices you've cloned. Use the id field as voice_id in synthesis requests.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}},"urlObject":{"path":["voices"],"host":["https://api.sonexlabs.com/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"cf67e1af-fc22-4389-ad93-a58183bf4029"},{"name":"GET /voices/{voice_id} — Get voice details","id":"7e85f9f0-5bd3-44ef-82a2-7af03166ee1f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.sonexlabs.com/v1/voices/REPLACE_WITH_VOICE_ID","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}},"urlObject":{"path":["voices","REPLACE_WITH_VOICE_ID"],"host":["https://api.sonexlabs.com/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"7e85f9f0-5bd3-44ef-82a2-7af03166ee1f"},{"name":"POST /voices/clone — Clone a voice (via file)","id":"fd9680c2-df26-4b9c-9bb9-5fec2a4d8a7a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"name","value":"My Cloned Voice","type":"text"},{"key":"file","type":"file","value":null}]},"url":"https://api.sonexlabs.com/v1/voices/clone","description":"

Multipart form. Provide exactly one of file (uploaded reference audio, WAV/MP3, min ~10s) or audio_url (publicly reachable URL). name is required. Your account has a limited number of custom voice clone slots — see the Platform API Guide.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}},"urlObject":{"path":["voices","clone"],"host":["https://api.sonexlabs.com/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"fd9680c2-df26-4b9c-9bb9-5fec2a4d8a7a"},{"name":"POST /voices/clone — Clone a voice (via audio_url)","id":"678d835a-c9d6-4f81-ba0d-de694fe048db","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"name","value":"My Cloned Voice","type":"text"},{"key":"audio_url","value":"https://example.com/reference.wav","type":"text"}]},"url":"https://api.sonexlabs.com/v1/voices/clone","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}},"urlObject":{"path":["voices","clone"],"host":["https://api.sonexlabs.com/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"678d835a-c9d6-4f81-ba0d-de694fe048db"},{"name":"DELETE /voices/{voice_id} — Delete a cloned voice","id":"20052d63-ceb7-4ce6-9fc7-93e81e4650dc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.sonexlabs.com/v1/voices/REPLACE_WITH_VOICE_ID","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}},"urlObject":{"path":["voices","REPLACE_WITH_VOICE_ID"],"host":["https://api.sonexlabs.com/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"20052d63-ceb7-4ce6-9fc7-93e81e4650dc"}],"id":"14dda1ec-5d17-4807-af32-2e310d22a94c","_postman_id":"14dda1ec-5d17-4807-af32-2e310d22a94c","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}}},{"name":"Account","item":[{"name":"GET /balance — Wallet + credits","id":"425edd51-3749-420f-be7e-0ee88e6662cb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0a8o}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.sonexlabs.com/v1/balance","description":"

Returns current wallet balance and remaining service credits (including TTS character balance and expiry).

\n","urlObject":{"path":["balance"],"host":["https://api.sonexlabs.com/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"425edd51-3749-420f-be7e-0ee88e6662cb"}],"id":"85200db2-c82d-424a-8e82-af3b77dabc01","_postman_id":"85200db2-c82d-424a-8e82-af3b77dabc01","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]},"isInherited":true,"source":{"_postman_id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","id":"7c1e2b9a-2340-43e3-9ff0-19b35f92c6de","name":"SonexLabs API Documentation","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_secret_0pcz}}"}]}},"event":[{"listen":"prerequest","script":{"id":"f00d0b77-29d7-486b-bcd8-d066d077df80","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"40a7c837-5b11-4986-87cd-86670c88cc86","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"base_url","value":"https://api.sonexlabs.com/v1"},{"key":"sonex_api_key","value":"vsk_REPLACE_ME"},{"key":"voice_id","value":"REPLACE_WITH_VOICE_ID"},{"key":"auth_secret_0a8o","secret":true},{"key":"auth_secret_0pcz","secret":true}]}