{"info":{"_postman_id":"91cee129-a3fd-4cb4-bf35-73430040684e","name":"AiVOOV - API","description":"<html><head></head><body><h1 id=\"aivoov-text-to-speech-api\">AiVOOV Text-to-Speech API</h1>\n<p>Access all the best text-to-speech AI voices from Google, Amazon, IBM and Microsoft using AiVOOV text-to-speech API. Our <a href=\"http://aivoov.com/\">AI voice generator</a> provides a single interface to convert text to audio using voices across different providers.</p>\n<p>Using a single text-to-speech API in your projects saves you time and offers many benefits:</p>\n<ol>\n<li><p>You instantly get access to all the voices from Google, Amazon, IBM and Microsoft.</p>\n</li>\n<li><p>You maintain only one API integration.</p>\n</li>\n<li><p>You don't have to worry about API upgrades or changes made on Google, Amazon, IBM and Microsoft.</p>\n</li>\n<li><p>Any new voices added on these platforms are instantly available to you.</p>\n</li>\n</ol>\n<p>Take a look at the <a href=\"https://aivoov.com/voices\">Voice List page</a> to see a list of the available voices and languages. The file also contains audio samples to help you pick.</p>\n<p><strong>Note:</strong> You need to have a AiVOOV account with Characters Credit to be able to access the API.</p>\n<h2 id=\"overview-of-api\">Overview of API</h2>\n<p>But first, we need authentication!</p>\n<h2 id=\"authentication\">Authentication</h2>\n<p>All endpoints require authentication. Authentication consists of two required HTTPS headers:</p>\n<ul>\n<li><code>X-API-KEY</code>: This is where your api key goes.</li>\n</ul>\n<p>To access your credentials, make sure you're logged-in to your aivoov.com account, then visit your <a href=\"https://aivoov.com/user/my_profile\">Profile page</a> -&gt; API.</p>\n<h2 id=\"endpoints\">Endpoints</h2>\n<ul>\n<li>Base URL: <code>https://aivoov.com/api/v8/</code></li>\n</ul>\n<p><strong>Notes:</strong></p>\n<ul>\n<li><p>All endpoints are relative to the base URL.</p>\n</li>\n<li><p>Requests should always be in form-data format, with a <code>Content-Type: multipart/form-data</code> header.</p>\n</li>\n</ul>\n<h1 id=\"aivoov-api-documentation\">Aivoov API Documentation</h1>\n<h2 id=\"check-postman-collection\">Check postman collection</h2>\n<p><a href=\"https://documenter.getpostman.com/view/5434397/2sB2qXki3a\">https://documenter.getpostman.com/view/5434397/2sB2qXki3a</a></p>\n<h2 id=\"overview\">Overview</h2>\n<p>This document describes how to interact with the Aivoov API to:</p>\n<ul>\n<li><p>Retrieve available voice IDs</p>\n</li>\n<li><p>Generate audio using multiple voice IDs and text inputs</p>\n</li>\n</ul>\n<hr>\n<h2 id=\"🔐-authentication\">🔐 Authentication</h2>\n<p>All requests must include your API key in the <code>X-API-KEY</code> header.</p>\n<hr>\n<h2 id=\"🎤-get-all-voice-ids\">🎤 Get All Voice IDs</h2>\n<p>Use the following endpoint to retrieve the list of available voice IDs.<br>You can also use the language_code parameter in the query string to filter voices by language.<br>For example:<br><a href=\"https://aivoov.com/api/v8/voices?language_code=en-US\">https://aivoov.com/api/v8/voices?language_code=en-US</a></p>\n<p>Retrieve all language names from this file.<br><a href=\"https://github.com/AiVOOV/aivoov-api/blob/main/Languages.md\">https://github.com/AiVOOV/aivoov-api/blob/main/Languages.md</a></p>\n<h3 id=\"request\">Request</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\">curl -i -X GET \\\n   -H \"X-API-KEY:YOUR-API-KEY\" \\\n   'https://aivoov.com/api/v8/voices'\n\n</code></pre>\n<p><strong>Note:</strong> This endpoint api daily call limit is 20. So you can store the all voices in your database and use as your requirement.</p>\n<h3 id=\"response-example\">Response Example</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">[\n  {\n    \"voice_id\": \"a9c6e858-cbcb-4380-91e5-21cea93be41f\",\n    \"name\": \"English Male 1\",\n    \"language\": \"en-US\"\n  },\n  ...\n]\n\n</code></pre>\n<hr>\n<h2 id=\"🔊-create-audio-with-multiple-voice-and-text-inputs\">🔊 Create Audio with Multiple Voice and Text Inputs</h2>\n<p>Use this endpoint to generate audio using multiple <code>voice_id</code> and <code>transcribe_text</code> pairs, with optional SSML pitch and speaking rate adjustments.</p>\n<h3 id=\"request-1\">Request</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\">curl -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</code></pre>\n<h3 id=\"parameters\">Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>voice_id[]</code></td>\n<td>string[]</td>\n<td>Voice ID for each text input</td>\n</tr>\n<tr>\n<td><code>transcribe_text[]</code></td>\n<td>string[]</td>\n<td>Text to be synthesized</td>\n</tr>\n<tr>\n<td><code>transcribe_ssml_pitch_rate[]</code></td>\n<td>int[]</td>\n<td>Pitch adjustment (optional, pass <code>default</code> for default rate), is in the closed interval of <code>[-50, 50]</code>. Use this to pitch-low, or pitch-low thespeaking pitch of the speech.</td>\n</tr>\n<tr>\n<td><code>transcribe_ssml_spk_rate[]</code></td>\n<td>int[]</td>\n<td>Speaking rate adjustment (optional, pass <code>default</code> for default rate) is in the closed interval of <code>[20, 200]</code>. Use this to speed-up, or slow-down the speaking rate of the speech.</td>\n</tr>\n<tr>\n<td><code>transcribe_ssml_volume[]</code></td>\n<td>int[]</td>\n<td>Speaking volume adjustment (optional, pass <code>default</code> for default volume) is in the closed interval of <code>[-40, 40]</code>. Use this to high or low the speaking volume of the speech.</td>\n</tr>\n</tbody>\n</table>\n</div><blockquote>\n<p>Note: All array parameters should be in the same order to match voice and text pairs. </p>\n</blockquote>\n<h3 id=\"response-example-1\">Response Example</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"status\": true,\n  \"message\": \"Audio successfully generated\",\n  \"audio\": \"Base64 encoded audio\"\n}\n\n</code></pre>\n<hr>\n<h2 id=\"rate-limits\">Rate Limits</h2>\n<p>We limit the rate of our APIs to prevent abuse. The specific limits are based on the API you are using.</p>\n<p><strong>Summary of the limits</strong></p>\n<p>Endpoint <code>v8/create</code> Max Requests per Minute (RPM) <code>75</code><br>All GET endpoints <code>100</code></p>\n<h2 id=\"example\">Example</h2>\n<h3 id=\"jquery\">jQuery</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>  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</code></pre><h3 id=\"nodejs\">NodeJs</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>  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</code></pre><h3 id=\"php-curl\">PHP cURL</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>    $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 =&gt; 'https://aivoov.com/api/v8/create',\n    CURLOPT_RETURNTRANSFER =&gt; true,\n    CURLOPT_ENCODING =&gt; '',\n    CURLOPT_MAXREDIRS =&gt; 10,\n    CURLOPT_TIMEOUT =&gt; 0,\n    CURLOPT_FOLLOWLOCATION =&gt; true,\n    CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,\n    CURLOPT_CUSTOMREQUEST =&gt; 'POST',\n    CURLOPT_POSTFIELDS =&gt;$data,\n    CURLOPT_HTTPHEADER =&gt; 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</code></pre></body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"AiVOOV Text-to-Speech API","slug":"aivoov-text-to-speech-api"},{"content":"Aivoov API Documentation","slug":"aivoov-api-documentation"}],"owner":"5434397","collectionId":"91cee129-a3fd-4cb4-bf35-73430040684e","publishedId":"2sB2qXki3a","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-05-19T10:07:09.000Z"},"item":[{"name":"Transcribe","id":"919f4435-2907-46e6-9b29-32999724ce86","protocolProfileBehavior":{"disabledSystemHeaders":{"content-type":true},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-API-KEY","value":"YOUR-API-KEY","type":"text"},{"key":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"voice_id[]","value":"a9c6e858-cbcb-4380-91e5-21cea93be41f","type":"text"},{"key":"transcribe_text[]","value":"hello world","type":"text"},{"key":"transcribe_ssml_pitch_rate[]","value":"default","type":"text"},{"key":"transcribe_ssml_spk_rate[]","value":"default","type":"text"},{"key":"transcribe_ssml_pitch_rate[]","value":"default","type":"text"}]},"url":"https://aivoov.com/api/v8/create","urlObject":{"protocol":"https","path":["api","v8","create"],"host":["aivoov","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"919f4435-2907-46e6-9b29-32999724ce86"},{"name":"Voices","id":"7973d48f-2cc4-4cd1-bb20-1c972f3ff377","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"x-api-key","value":"YOUR-API-KEY","type":"text"}],"url":"https://aivoov.com/api/v8/voices?language_code=en-US","urlObject":{"protocol":"https","path":["api","v8","voices"],"host":["aivoov","com"],"query":[{"key":"language_code","value":"en-US"}],"variable":[]}},"response":[],"_postman_id":"7973d48f-2cc4-4cd1-bb20-1c972f3ff377"}]}