{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"bb0b6bea-bcd2-470c-9d60-3ddb6ad138f2","name":"DeepZen Text-To-Speech API","description":"DeepZen Text-To-Speech API is a private API. Please send a request for access by contacting us via [developers@deepzen.io](https://mailto:developers@deepzen.io).\n\n# Authorization\n\nOnce you have your access tokens, you should pass it with all of your requests using `Authorization` header like this:\n\n```\nAuthorization: ApiToken {YOUR_TOKEN}\n\n ```\n\n# Concepts\n\n## Jobs & Webhooks\n\nAll synthesis requests return a `Job ID`. It's a good practice to provide `webhook_url` for all long synthesis requests to avoid possible timeout. Provided `webhook_url` will be called with the output of the job and the job ID that you get when you call the endpoint.\n\nValidation errors will be returned immediately when you call an endpoint. If you don't provide a webhook url, HTTP request will be held until synthesis completes and job success output is returned immediately.\n\n## Available Voices\n\nAs we continuously license more voices, they will be made available here. Below is a list of available voices:\n\n- **US Male**: `edward`, `todd`\n- **US Female**: `kellie`, `dahlia`, `zoe` , `cora`, `jen-austin`\n- **Alfro-American Accent**: `joe`\n- **UK Male**: `william`\n- **UK Female**: `alice`, `lauren`, `elaine`\n- **French Male**: `sylvain`, `cedric`\n- **French Female**: `melissa`\n- **German Male**: `david`, `otto`, `ben`\n- **German Female**: `anja`\n- **Turkish Male**: `emrah`\n- **Turkish Female**: `basak`\n- **Mexican Male**: `santiago`\n- **Mexican Female**: `sabrina`\n    \n\n## Emotion Control\n\nOne of 7 emotions and corresponding intensities can be selected at synthesis time.\n\n- **Emotions:** `anger`, `disgust`, `excited`, `fear`, `happy`, `sad`, `surprise`.\n- **Intensity:** `low`, `medium`, `high`.\n    \n\n**Note: Every voice is unique, hence their emotional intensities will differ.**\n\n## SSML\n\n`ssml` flag must be set to `true` for SSML tags to work (see sample code from `Create Session`). The `speak` tag is the root element. **All SSML-enhanced text must be enclosed by a pair of opening and closing** **`speak`** **tags** (see sample code from `Create Session`) although we omit them in some of the examples given below. Apart from the root tag, supported elements are:\n\n- `p` paragraph tag:  \n    `This is a paragraph.`\n- `s` sentence tag, this is equivalent to ending a sentence with a period (.):  \n    `~~This is a sentence~~`\n- `sub` substitution tag used with attribute `alias` to substitute a different word:  \n    `Hg`\n- `break` tag used with attribute `strength` to specify a pause. Accepted strength values are:  \n    `none`, `weak`, `medium`, `strong`, `extra-long`:  \n    `A little lamb whose fleece was grey`\n- `phoneme` tag used with attribute `ph` specifies the pronunciation using International Phonetic Alphabet (IPA) alphabet (stress mark must be after the vowel):  \n    `pecan`\n- `emphasis` tag used with `level` attribute: `none`, `medium`, `strong`:  \n    `really`\n- `say-as` tag used with attribute `interpret-as` to interpret non-standard words. Accepted categories are: `spell-out` (initialisms), `digits` (also spelled out), `ordinal`, `cardinal`, `year`:  \n    `1900`\n- `mark` tag used with attribute `name` to retrieve a time-stamp on given text location:  \n    `A little lamb`\n    \n\nThe output payload will contain a dict `marks`: `{\"end\": time in seconds}`\n\n## Streaming\n\nOptionally for faster response to requests, streaming can be implemented using DeepZen Javascript SDK. This enables the voice to start streaming before the synthesis is completed. The public repository is located here: [https://bitbucket.org/deepzenio/sdk-js/](https://bitbucket.org/deepzenio/sdk-js/) Please refer to `README` and `examples` for details.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"32143694","team":5945151,"collectionId":"bb0b6bea-bcd2-470c-9d60-3ddb6ad138f2","publishedId":"2s9YsGhszG","public":true,"publicUrl":"https://developers.deepzen.io","privateUrl":"https://go.postman.co/documentation/32143694-bb0b6bea-bcd2-470c-9d60-3ddb6ad138f2","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"0096FF"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"system_default","themes":[{"name":"dark","logo":"https://content.pstmn.io/31542e79-6310-40cf-9c3e-96901f71706e/RGVlcHplbl9FbWFpbExvZ28ucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"0096FF"}},{"name":"light","logo":"https://content.pstmn.io/f58a9f04-4ec2-4c22-8eb6-e7337e2ba2e3/RGVlcFplbi5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"0096FF"}}]}},"version":"8.10.0","publishDate":"2024-01-04T23:16:43.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/f58a9f04-4ec2-4c22-8eb6-e7337e2ba2e3/RGVlcFplbi5wbmc=","logoDark":"https://content.pstmn.io/31542e79-6310-40cf-9c3e-96901f71706e/RGVlcHplbl9FbWFpbExvZ28ucG5n"}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/7a5fbb8ec0ccafa71505d1faaeb8de71b8ca3da6d98083cb996ba48b634a58bc","favicon":"https://deepzen.io/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://developers.deepzen.io/view/metadata/2s9YsGhszG"}