{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"91cee129-a3fd-4cb4-bf35-73430040684e","name":"AiVOOV - API","description":"# AiVOOV Text-to-Speech API\n\nAccess all the best text-to-speech AI voices from Google, Amazon, IBM and Microsoft using AiVOOV text-to-speech API. Our [AI voice generator](http://aivoov.com/) provides a single interface to convert text to audio using voices across different providers.\n\nUsing a single text-to-speech API in your projects saves you time and offers many benefits:\n\n1. You instantly get access to all the voices from Google, Amazon, IBM and Microsoft.\n    \n2. You maintain only one API integration.\n    \n3. You don't have to worry about API upgrades or changes made on Google, Amazon, IBM and Microsoft.\n    \n4. Any new voices added on these platforms are instantly available to you.\n    \n\nTake a look at the [Voice List page](https://aivoov.com/voices) to see a list of the available voices and languages. The file also contains audio samples to help you pick.\n\n**Note:** You need to have a AiVOOV account with Characters Credit to be able to access the API.\n\n## Overview of API\n\nBut first, we need authentication!\n\n## Authentication\n\nAll endpoints require authentication. Authentication consists of two required HTTPS headers:\n\n- `X-API-KEY`: This is where your api key goes.\n    \n\nTo access your credentials, make sure you're logged-in to your aivoov.com account, then visit your [Profile page](https://aivoov.com/user/my_profile) -> API.\n\n## Endpoints\n\n- Base URL: `https://aivoov.com/api/v8/`\n    \n\n**Notes:**\n\n- All endpoints are relative to the base URL.\n    \n- Requests should always be in form-data format, with a `Content-Type: multipart/form-data` header.\n    \n\n# Aivoov API Documentation\n\n## Check postman collection\n\n[https://documenter.getpostman.com/view/5434397/2sB2qXki3a](https://documenter.getpostman.com/view/5434397/2sB2qXki3a)\n\n## Overview\n\nThis document describes how to interact with the Aivoov API to:\n\n- Retrieve available voice IDs\n    \n- Generate audio using multiple voice IDs and text inputs\n    \n\n---\n\n## 🔐 Authentication\n\nAll requests must include your API key in the `X-API-KEY` header.\n\n---\n\n## 🎤 Get All Voice IDs\n\nUse the following endpoint to retrieve the list of available voice IDs.  \nYou can also use the language_code parameter in the query string to filter voices by language.  \nFor example:  \n[https://aivoov.com/api/v8/voices?language_code=en-US](https://aivoov.com/api/v8/voices?language_code=en-US)\n\nRetrieve all language names from this file.  \n[https://github.com/AiVOOV/aivoov-api/blob/main/Languages.md](https://github.com/AiVOOV/aivoov-api/blob/main/Languages.md)\n\n### Request\n\n``` bash\ncurl -i -X GET \\\n   -H \"X-API-KEY:YOUR-API-KEY\" \\\n   'https://aivoov.com/api/v8/voices'\n\n ```\n\n**Note:** This endpoint api daily call limit is 20. So you can store the all voices in your database and use as your requirement.\n\n### Response Example\n\n``` json\n[\n  {\n    \"voice_id\": \"a9c6e858-cbcb-4380-91e5-21cea93be41f\",\n    \"name\": \"English Male 1\",\n    \"language\": \"en-US\"\n  },\n  ...\n]\n\n ```\n\n---\n\n## 🔊 Create Audio with Multiple Voice and Text Inputs\n\nUse this endpoint to generate audio using multiple `voice_id` and `transcribe_text` pairs, with optional SSML pitch and speaking rate adjustments.\n\n### Request\n\n``` bash\ncurl -i -X POST \\\n   -H \"Content-Type:application/x-www-form-urlencoded\" \\\n   -H \"X-API-KEY:YOUR-API-KEY\" \\\n   -d \"voice_id[]=a9c6e858-cbcb-4380-91e5-21cea93be41f\" \\\n   -d \"transcribe_text[]=hello world\" \\\n   -d \"transcribe_ssml_pitch_rate[]=-50\" \\\n   -d \"transcribe_ssml_spk_rate[]=1\" \\\n   -d \"voice_id[]=a9c6e858-cbcb-4380-91e5-21cea93be41f\" \\\n   -d \"transcribe_text[]=how are you\" \\\n   -d \"transcribe_ssml_pitch_rate[]=10\" \\\n   -d \"transcribe_ssml_spk_rate[]=-10\" \\\n   'https://aivoov.com/api/v8/create'\n\n ```\n\n### Parameters\n\n| Parameter | Type | Description |\n| --- | --- | --- |\n| `voice_id[]` | string\\[\\] | Voice ID for each text input |\n| `transcribe_text[]` | string\\[\\] | Text to be synthesized |\n| `transcribe_ssml_pitch_rate[]` | int\\[\\] | Pitch adjustment (optional, pass `default` for default rate), is in the closed interval of `[-50, 50]`. Use this to pitch-low, or pitch-low thespeaking pitch of the speech. |\n| `transcribe_ssml_spk_rate[]` | int\\[\\] | Speaking rate adjustment (optional, pass `default` for default rate) is in the closed interval of `[20, 200]`. Use this to speed-up, or slow-down the speaking rate of the speech. |\n| `transcribe_ssml_volume[]` | int\\[\\] | Speaking volume adjustment (optional, pass `default` for default volume) is in the closed interval of `[-40, 40]`. Use this to high or low the speaking volume of the speech. |\n\n> Note: All array parameters should be in the same order to match voice and text pairs. \n  \n\n### Response Example\n\n``` json\n{\n  \"status\": true,\n  \"message\": \"Audio successfully generated\",\n  \"audio\": \"Base64 encoded audio\"\n}\n\n ```\n\n---\n\n## Rate Limits\n\nWe limit the rate of our APIs to prevent abuse. The specific limits are based on the API you are using.\n\n**Summary of the limits**\n\nEndpoint `v8/create` Max Requests per Minute (RPM) `75`  \nAll GET endpoints `100`\n\n## Example\n\n### jQuery\n\n```\n  var settings = {\n  \"url\": \"https://aivoov.com/api/v8/create\",\n  \"method\": \"POST\",\n  \"timeout\": 0,\n  \"headers\": {\n    \"X-API-KEY\": \"YOUR-API-KEY\",\n    \"Content-Type\": \"application/x-www-form-urlencoded\"\n  },\n  \"data\": {\n    \"voice_id[]\": \"a9c6e858-cbcb-4380-91e5-21cea93be41f\",\n    \"transcribe_text[]\": \"hello world\",\n    \"transcribe_ssml_pitch_rate[]\": \"default\",\n    \"transcribe_ssml_spk_rate[]\": \"default\",\n    \"transcribe_ssml_pitch_rate[]\": \"default\"\n  }\n};\n$.ajax(settings).done(function (response) {\n  console.log(response);\n});\n\n ```\n\n### NodeJs\n\n```\n  var request = require('request');\n  var options = {\n    'method': 'POST',\n    'url': 'https://aivoov.com/api/v8/create',\n    'headers': {\n      'X-API-KEY': 'YOUR-API-KEY',\n      'Content-Type': 'application/x-www-form-urlencoded',==\n    },\n    form: {\n      'voice_id[]': 'a9c6e858-cbcb-4380-91e5-21cea93be41f',\n      'transcribe_text[]': 'hello world',\n      'transcribe_ssml_pitch_rate[]': 'default',\n      'transcribe_ssml_spk_rate[]': 'default',\n      'transcribe_ssml_pitch_rate[]': 'default'\n    }\n  };\n  request(options, function (error, response) {\n    if (error) throw new Error(error);\n    console.log(response.body);\n  });\n\n ```\n\n### PHP cURL\n\n```\n    $data['voice_id[]'] = \"a9c6e858-cbcb-4380-91e5-21cea93be41f\"; \n  $data['transcribe_text[]'] = \"Hello world.\"; \n  $data['transcribe_ssml_pitch_rate[]'] = \"default\"; \n  $data['transcribe_ssml_spk_rate[]'] = \"default\";  \n  $data['transcribe_ssml_pitch_rate[]'] = \"default\";  \n  $curl = curl_init();\n  curl_setopt_array($curl, array(\n    CURLOPT_URL => 'https://aivoov.com/api/v8/create',\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_ENCODING => '',\n    CURLOPT_MAXREDIRS => 10,\n    CURLOPT_TIMEOUT => 0,\n    CURLOPT_FOLLOWLOCATION => true,\n    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n    CURLOPT_CUSTOMREQUEST => 'POST',\n    CURLOPT_POSTFIELDS =>$data,\n    CURLOPT_HTTPHEADER => array(\n      'X-API-KEY: YOUR-API-KEY',\n      'Content-Type: application/x-www-form-urlencoded'\n    ),\n  ));\n  $response = curl_exec($curl);\n  curl_close($curl);\n  echo $response;\n\n ```","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"5434397","team":1180843,"collectionId":"91cee129-a3fd-4cb4-bf35-73430040684e","publishedId":"2sB2qXki3a","public":true,"publicUrl":"https://documenter-api.postman.tech/view/5434397/2sB2qXki3a","privateUrl":"https://go.postman.co/documentation/5434397-91cee129-a3fd-4cb4-bf35-73430040684e","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2025-05-19T10:07:09.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"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/368d2227d4eb0ec39f282e72d252c66acab19ffd0bb5c990ced9b6e6c809f683","favicon":""},"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://documenter.gw.postman.com/view/metadata/2sB2qXki3a"}