Инструкция на API за текст в говор

03-07-2023 , 03-07-2023

API е достъпен само след като сте финансирали акаунта си.

JSON API гласове https://speechgen.io/index.php?r=api/voices.

Има 2 опции за текстов глас чрез API:

1 опция - бързо озвучаване на кратки текстове.
2 опция - задаване на задача за глас зад кадър.

1 опция - бързо озвучаване на кратки текстове

URL адрес за вариант 1: https://speechgen.io/index.php?r=api/text

Текстът се изпраща до API, получавате незабавни резултати.

Тази опция има максимално ограничение от 2000 знака. И също така максимум 2 гласови промени. Ако ограниченията са превишени, ще получите грешка(status = -1).

Формат на заявката


$data = [
	'token'=>'SekretKeyInYourProfile',
	'email'=>'yourMail@gmail.com',
	'voice'=>'John',
	'text'=>"Text for text to Speech", 
	'format'=>'mp3',
	'speed'=>1.1, 
	'pitch'=>0.8,   
	'emotion'=>'good', 
	];

Задължителни параметри:


'token' - 'SekretKeyInYourProfile'
'email' - 'yourMail@gmail.com'
'voice' - 'Voice'
'text' - 'Text for text to Speech'

Незадължителни параметри:


'format' - format of the resulting file, by default = mp3, possible values ( 'mp3', 'wav', 'ogg')
'speed' - playback speed, by default 1, (range from  0.1 to 2.0) 
'pitch'- voice pitch, by default 0, (range from -20 to 20)    
'emotion' - emotion of voice , by default 'good', possible values ( 'good',  'evil', 'neutral').

Емоция Не се предлага за всички гласове, вижте го тук.

Отговорът идва в JSON:


{
"id":"4153594",
"status":"0",
"file":"result.mp3",
"file_cors":"result_cors.mp3",
"parts":"5",
"parts_done":"2",
"duration":"0",
"format":"mp3",
"error":"",
"balans":"3331.2720000314",
"cost":"0.06"
}

Описание:


"id" - unique voice ID
"status" - current voiceover status. Available from 3 values:
    0  - process
    1  - completed successfully
    -1 - error 
"file" - audio file path, available if status= 1
"file_cors" - audio file path CORS
"error" - error text, in the event of, if status =  -1
"parts"  - number of voiceovers
"parts_done" - number of pieces completed
"duration"  - audio file duration in seconds, available if status  = 1
"format" - audio file format
"balans" - limit balance
"cost" - voiceover costs. (is increased as the voice parts are dubbed)

Пример за кратък гласов текст в PHP вариант 1


$data = [
    'token' => '123456',
    'email' => 'mail@mail.com',
    'voice' => 'John',
    'text' => "Text",
    'format' => 'mp3',
    'speed' => 1.1,
    'pitch' => 0,
    'emotion' => 'good',
];
$url = "https://speechgen.io/index.php?r=api/text";
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
 
$response = curl_exec($ch);
var_dump($response);
$response = json_decode($response, true);
if (curl_errno($ch)) {
    var_dump("Connection error with text recognition server, " . curl_error($ch));
} else {
    var_dump($response);
    if ($response["status"] == 1) {
        //Copy
        echo " ok " . $response["file"];
        copy($response["file"], 'Filename.' . $response["format"]);
    } else {
        //Error, no voiceover possible
        echo $response["error"];
    }
}
curl_close($ch);

Вариант 2 е да зададете задача за озвучаване на текста.

URL за опция 2: https://speechgen.io/index.php?r=api/longtext

Стъпка 1: Текстът се изпраща до API и се получава уникален гласов идентификатор (id).
Стъпка 2: Поискайте резултата от дублажа, като изпратите идентификатора за дублаж (id).

Този метод няма ограничения и позволява дублиране на текст до 1 000 000 знака. Дублажът се извършва по приоритет (първи дошъл, първи обслужен) и може да отнеме от 1 до няколко минути, в зависимост от дължината на текста.

Формат на заявката


$data = [
	'token'=>'SekretKeyInYourProfile',
	'email'=>'yourMail@gmail.com',
	'voice'=>'John',
	'text'=>"Text", 
	'format'=>'mp3',
	'speed'=>1.1, 
	'pitch'=>0.8,   
	'emotion'=>'good', 
	];

Задължителни параметри:


'token' - 'SekretKeyInYourProfile'
'email' - 'yourMail@gmail.com'
'voice' - 'Voice'
'text' - 'Text'

Незадължителни параметри:


'format' - format of the resulting file, by default = mp3, possible values( 'mp3', 'wav', 'ogg')
'speed' - speed, by default 1, (range from 0.1 to 2.0) 
'pitch'- voice pitch, by default 0, (range from -20 to 20)    
'emotion' - emotional coloration, by default  'good', possible values ( 'good',  'evil', 'neutral').

Не се предлага за всички гласове, вижте тук.

Отговорът идва в JSON:


{
"id":"4153594",
"status":"0",
"parts":"5",
"parts_done":"0",
"format":"mp3",
"error":"",
"balans":"3331.2720000314",
"cost":"0.00"
}

Описание:


"id" - unique voice ID
"status" - current voiceover status. Available from 2 values:
    1  - task added successfully
    -1 - error 
"error" - error text, in case of, if status =  -1
"parts"  - number of voiceovers
"parts_done" - number of pieces completed
"format" - audio file format
"balans" - the balance of the account limits
"cost" - voiceover costs. ( is increased as the voice parts are dubbed)

Стъпка 2. След създаване на задача и получаване на идентификатор (id) трябва да се изпрати заявка доhttps://speechgen.io/index.php?r=api/result, to find out the result.

Формат на заявката


$data = [
	'token'=>'SekretKeyInYourProfile',
	'email'=>'yourMail@gmail.com',
	'id'=>4153594, 
];

Задължителни параметри:


'token' - SekretKeyInYourProfile
'email' - yourMail@gmail.com
'id' - Unique voice ID obtained in step 1

Отговорът идва в JSON:


{
"id":"4153594",
"status":"0",
"file":"result.mp3",
"cuts":["result_1.mp3","result_2.mp3",...],
"parts":"5",
"parts_done":"0",
"format":"mp3",
"error":"",
"balans":"3331.2720000314",
"cost":"0.00"
}

Описание:


"id" - unique voice ID
"status" - current voiceover status. Available from 3 values:
    0  - in the midst of
    1  - completed successfully
    -1 - error 
"file" - audio file path, available if status = 1
"error" - error text, in case of, if status =  -1
"parts"  - number of voiceovers
"parts_done" - number of pieces completed
"duration"  - audio file duration in seconds, available if status = 1
"format" - audio file format
"balans" - the balance of the account limits
"cost" - voiceover costs. ( is increased as the voice parts are dubbed)
"cuts" - Array of fragments, if the "cut" tag is used in the text

Пример за кратък тестов глас зад кадър в PHP вариант 2


//STEP 1
$data = [
    'token' => '123456',
    'email' => 'mail@mail.com',
    'voice' => 'John',
    'text' => "Text",
    'format' => 'mp3',
    'speed' => 1.1,
    'pitch' => 0,
    'emotion' => 'good',
];
$url = "https://speechgen.io/index.php?r=api/longtext";
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
 
$response = curl_exec($ch);
var_dump($response);
$response = json_decode($response, true);
$resultId = 0;
if (curl_errno($ch)) {
    var_dump("Error in connecting to the text recognition server, " . curl_error($ch));
} else {
    var_dump($response);
    if ($response["status"] == 1) {
        //Copy
        echo " ok " . $response["file"];
        copy($response["file"], 'FileName.' . $response["format"]);
    } elseif ($response["status"] == 0) {
        //Remember the voice ID, and ask for the result later
        $resultId = $response["id"];
    } else {
        //Error, no voiceover possible
        echo $response["error"];
    }
}
curl_close($ch);
 
 
 
//STEP 2
// Всяка минута правим query-check на резултата
if($resultId){
    $data = [
        'token'=>'123456',
        'email'=>'mail@mail.com',
        'id'=>$resultId, 
    ];    
    $url = "https://speechgen.io/index.php?r=api/result";
 
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_HEADER, false);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);                
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));    
 
    $response = curl_exec($ch); 
    var_dump($response);
    $response = json_decode($response,true);
    if (curl_errno($ch)) {
        var_dump("Error in connecting to the text recognition server, ".curl_error($ch));
    }else{ 
        var_dump($response);
        if($response["status"] == 1){
            //Copy
            echo "  ok ".$response["file"];
            copy($response["file"], 'FileMane.' . $response["format"]);
        }elseif($response["status"] == 0){
            //Not ready yet, we will ask for the result later
            echo "In process...";
        }else{
            //Error, no voiceover possible
            echo $response["error"];
        }
    }
    curl_close($ch);
}

Инструкции

Разработчик

Инструкция на API за текст в говор

1 опция - бързо озвучаване на кратки текстове

Текстът се изпраща до API, получавате незабавни резултати.

Формат на заявката

Задължителни параметри:

Незадължителни параметри:

Отговорът идва в JSON:

Описание:

Пример за кратък гласов текст в PHP вариант 1

Вариант 2 е да зададете задача за озвучаване на текста.

URL за опция 2: https://speechgen.io/index.php?r=api/longtext

Формат на заявката

Задължителни параметри:

Незадължителни параметри:

Отговорът идва в JSON:

Описание:

Формат на заявката

Задължителни параметри:

Отговорът идва в JSON:

Описание:

Пример за кратък тестов глас зад кадър в PHP вариант 2

Поддържа

Съдържание