HyperVoice Text to Speech API

The HyperVoice API allows developers to convert text into lifelike speech using advanced text-to-speech (TTS) technology. The API supports customizable voice options, including different actors and languages.

Authentication

To use the HyperVoice API, you must include your API key in the request headers. You can generate an API key by following these steps:

  1. Sign up or log in at HyperVoice.

  2. Launch the HyperVoice app.

  3. Navigate to the API page.

  4. Create a new API key.

Include the API key in the Authorization header as follows:

Authorization: Bearer YOUR-API-KEY

Base URL

https://taskagi.net/api

Text to Speech Endpoint

GET /api/hypervoice/text-to-speech

Endpoint Description

This endpoint generates an audio file from the provided text using a specified voice actor and speech speed. The generated audio file is returned as a URL.

Endpoint Parameters

Parameter

Parameter

Type

Required

Description

gen_text

string

Yes

The text to be converted into speech.

actor

string

Yes

The name of the voice actor to use for speech synthesis.

speed

integer

No

The speed of the speech. Acceptable values are between 0.1 and 2.0. Default is 1.0.

Example Request:

GET https://taskagi.net/api/hypervoice/text-to-speech?gen_text=Hello%20world!&actor=vits-john&speed=1.2

Python Sample Code

import requests

url = "https://taskagi.net/api/hypervoice/text-to-speech"
headers = {
    "Authorization": "Bearer YOUR-API-KEY"
}
params = {
    "gen_text": "Hello world!",
    "actor": "amelia-conversational",
    "speed": 1.2
}
response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    print(response.json()["audio_url"])
else:
    print(response.json())

PHP Sample Code

<?php

$url = "https://taskagi.net/api/hypervoice/text-to-speech";
$params = [
    "gen_text" => "Hello world!",
    "actor" => "arduin-angry",
    "speed" => 1.2
];
$headers = [
    "Authorization: Bearer YOUR-API-KEY"
];

$ch = curl_init();
$query = http_build_query($params);
curl_setopt($ch, CURLOPT_URL, "$url?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if (isset($data['audio_url'])) {
    echo $data['audio_url'];
} else {
    echo $response;
}

Supported Voice Actors

HyperVoice V2 actors are the most realistic with emotional capabilities and optimized for various use cases. These voices are available only in English. The average response time is around 8-10 seconds, depending on the length of your text.

Available V2 Actors:

  • mark

  • david

  • john

  • brad

  • denzel

  • mike

  • meri

  • amelia-conversational

  • august-conversational

  • charles

  • henry

  • jack-conversational

  • oliver

  • olivia

  • mars

  • jupiter

  • meri-asmr

  • irina-sobbing

  • eren-confident

  • raven-calm

  • arduin-angry

  • joe

HyperVoice V1 Actors

HyperVoice V1 supports 80 languages and is optimized for fast response, averaging less than a second in response times. These voices are ideal for speed-critical use cases.

  • us-male-1 (English / male)

  • us-male-2 (English / male)

  • us-male-3 (English / male)

  • us-male-4 (English / male)

  • us-male-4 (English / male)

  • us-male-5 (English / male)

  • us-female-1 (English / female)

  • us-female-2 (English / female)

  • us-female-3 (English / female)

  • us-female-4 (English / female)

  • us-female-5 (English / female)

  • us-female-6 (English / female)

  • vits-afr-1 (Afrikaans / female)

  • vits-afr-2 (Afrikaans / female)

  • vits-afr-3 (Afrikaans / female)

  • vits-afr-4 (Afrikaans / female)

  • vits-afr-5 (Afrikaans / female)

  • vits-afr-6 (Afrikaans / female)

  • vits-afr-7 (Afrikaans / female)

  • vits-afr-8 (Afrikaans / female)

  • vits-afr-9 (Afrikaans / female)

  • vits-aka-1 (Akan / male)

  • vits-ara-1 (Arabic / male)

  • vits-bam-1 (Bambara / male)

  • vits-bem-1 (Bemba / male)

  • vits-ben-1 (Bengali / female)

  • vits-ben-2 (Bengali / male)

  • vits-ben-3 (Bengali / male)

  • vits-ben-4 (Bengali / male)

  • vits-ben-5 (Bengali / male)

  • vits-ben-6 (Bengali / male)

  • vits-ben-7 (Bengali / male)

  • vits-ben-8 (Bengali / male)

  • vits-ben-9 (Bengali / male)

  • vits-ben-10 (Bengali / male)

  • vits-ben-11 (Bengali / male)

  • vits-ben-12 (Bengali / male)

  • vits-ben-13 (Bengali / male)

  • vits-bul-1 (Bulgarian / male)

  • vits-cat-1 (Catalan / male)

  • vits-cym-1 (Welsh / male)

  • vits-cze-1 (Czech / male)

  • vits-dan-1 (Danish / male)

  • vits-deu-1 (Deutsch / male)

  • vits-dzo-1 (Dzongkha / male)

  • vits-ell-1 (Greek / female)

  • vits-est-1 (Estonian / female)

  • vits-fas-1 (Farsi / male)

  • vits-fij-1 (Fijian / male)

  • vits-fin-1 (Finnish / male)

  • vits-fra-1 (French / male)

  • vits-guj-1 (Gujarati / female)

  • viits-guj-2 (Gujarati / male)

  • viits-guj-3 (Gujarati / female)

  • vits-hat-1 (Haitian Creole / male)

  • vits-hau-1 (Hausa / male)

  • vits-hay-1 (Haysa / male)

  • vits-heb-1 (Hebrew / male)

  • vits-hin-1 (Hindi / male)

  • vits-hun-1 (Hungarian / female)

  • vits-ind-1 (Indonesian / male)

  • vits-isl-1 (Icelandic / female)

  • vits-isl-2 (Icelandic / male)

  • vits-ita-1 (Italian / male)

  • vits-jam-1 (Jamaican Patois / male)

  • vits-jav-1 (Javanese / male)

  • vits-kat-1 (Georgian / female)

  • vits-kaz-1 (Kazakh / male)

  • vits-kaz-2 (Kazakh / male)

  • vits-kaz-3 (Kazakh / female)

  • vits-kaz-4 (Kazakh / female)

  • vits-kaz-5 (Kazakh / male)

  • vits-khm-1 (Khmer / male)

  • vits-kin-1 (Kinyarwanda / male)

  • vits-kir-1 (Kyrgyz / male)

  • vits-kor-1 (Korean / female)

  • vits-kri-1 (Krio / male)

  • vits-lao-1 (Lao / male)

  • vits-lav-1 (Latvian / male)

  • viits-lit-1 (Lithuanian / female)

  • vits-lug-1 (Luganda / male)

  • vits-mai-1 (Maithili / male)

  • vits-mar-1 (Marathi / male)

  • vits-mlg-1 (Malagasy / male)

  • vits-mlt-1 (Maltese / female)

  • vits-mnk-1 (Mandinka / male)

  • vits-mon-1 (Mongolian / male)

  • vits-mos-1 (Moore / male)

  • vits-mya-1 (Burmese / male)

  • vits-nep-1 (Nepali / female)

  • vits-nld-1 (Dutch / female)

  • vits-nld-2 (Dutch / male)

  • vits-nld-3 (Dutch / female)

  • vits-nor-1 (Norweigan / male)

  • vits-nya-1 (Chichewa / male)

  • vits-orm-1 (Oromo / male)

  • vits-pan-1 (Punjabi / male)

  • vits-pcm-1 (Nigerian Pidgin / male)

  • vits-pis-1 (Pijin / male)

  • vits-pol-1 (Polish / male)

  • vits-pol-2 (Polish / female)

  • vits-pol-3 (Polish / male)

  • vits-por-1 (Portuguese / male)

  • vits-por-2 (Portuguese / male)

  • vits-ron-1 (Romanian / male)

  • vits-run-1 (Kirundi / male)

  • vits-rus-1 (Russian / male)

  • vits-shn-1 (Shan / male)

  • vits-slk-1 (Slovak / female)

  • vits-slk-2 (Slovak / female)

  • vits-slv-1 (Slovene / male)

  • vits-sna-1 (Shona / male)

  • vits-som-1 (Somali / male)

  • vits-spa-1 (Spanish / male)

  • vits-sqi-1 (Albanian / male)

  • vits-srp-1 (Serbian / male)

  • vits-srp-2 (Serbian / male)

  • vits-sun-1 (Sundanese / male)

  • vits-swa-1 (Swahili / male)

  • vits-swe-1 (Swedish / male)

  • vits-tam-1 (Tamil / male)

  • vits-tel-1 (Telugu / male)

  • vits-tgk-1 (Tajik / male)

  • vits-tgl-1 (Tagalog / male)

  • vits-tha-1 (Thai / male)

  • vits-tpi-1 (Tok Pisin / male)

  • vits-tsn-1 (Setswana / female)

  • vits-tur-1 (Turkish / male)

  • vits-tur-2 (Turkish / male)

  • vits-ukr-1 (Ukrainian / male)

  • vits-vie-1 (Viet / female)

  • vits-vie-2 (Viet / female)

  • vits-vie-3 (Viet / female)

  • vits-vie-4 (Viet / male)

  • vits-vie-5 (Viet / female)

  • vits-zho-1 (Chinese Mandarin / female)

Updated on