Instruksi API untuk Text to Speech

29-12-2024 , 29-12-2024

API hanya tersedia setelah Anda mendanai akun Anda.

JSON API suara https://speechgen.io/index.php?r=api/voices.

Terdapat 2 opsi pengisian suara teks yang tersedia melalui API:

Opsi 1 - pengisian suara cepat untuk teks pendek.
Opsi 2 - pengaturan tugas pengisian suara.

Contoh Integrasi

Temukan cara menyederhanakan pembuatan konten suara dengan mengintegrasikan SpeechGen.io dengan layanan otomasi MAKE. Panduan ini mencakup proses otomatisasi text-to-speech, membuatnya lebih sederhana dan efisien untuk menghasilkan konten suara untuk berbagai aplikasi.

Opsi 1 - Pengisian suara cepat untuk teks pendek

Url untuk opsi 1: https://speechgen.io/index.php?r=api/text

Teks dikirim ke API, Anda mendapatkan hasil secara langsung.

Opsi ini memiliki batas maksimum 2000 karakter. Dan juga maksimum 2 pergantian suara. Jika batas ini terlampaui, Anda akan mendapatkan error (status = -1).

Format Permintaan


$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',
        'pause_sentence'=>300, 
        'pause_paragraph'=>400, 
        'bitrate'=>48000,  
	];

Parameter Wajib:


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

Parameter Opsional:


'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'). 
'pause_sentence' - The size of the pause between sentences in milliseconds.
'pause_paragraph' - The size of the pause between paragraphs in milliseconds.
'bitrate'=>48000 - Bitrate from 8000 to 192000 Hz.

Emosi Tidak tersedia untuk semua suara, lihat di sini.

Jawaban diterima dalam format 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"
}

Deskripsi:


"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)

Contoh pengisian suara teks pendek dalam PHP opsi 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);

Opsi 2 adalah pengaturan tugas pengisian suara untuk teks.

Url untuk opsi 2: https://speechgen.io/index.php?r=api/longtext

Langkah 1: Teks dikirim ke API dan ID suara unik diperoleh (id).
Langkah 2: Minta hasil pengisian suara dengan mengirimkan pengidentifikasi pengisian suara (id).

Metode ini tidak memiliki batasan dan memungkinkan pengisian suara teks hingga 1.000.000 karakter. Pengisian suara dilakukan sesuai prioritas (siapa cepat dia dapat) dan dapat memakan waktu dari 1 hingga beberapa menit, tergantung pada panjang teks.

Format Permintaan


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

Parameter Wajib:


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

Parameter Opsional:


'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'). 
'pause_sentence' - The size of the pause between sentences in milliseconds.
'pause_paragraph' - The size of the pause between paragraphs in milliseconds.
'bitrate'=>48000 - Bitrate from 8000 to 192000 Hz.

Tidak tersedia untuk semua suara, lihat di sini.

Jawaban diterima dalam format JSON:


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

Deskripsi:


"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)

Langkah 2. Setelah membuat tugas dan mendapatkan pengidentifikasi (id), permintaan harus dikirim ke https://speechgen.io/index.php?r=api/result, untuk mengetahui hasilnya.

Format Permintaan


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

Parameter Wajib:


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

Jawaban diterima dalam format 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"
}

Deskripsi:


"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

Contoh pengisian suara uji singkat dalam PHP opsi 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
// Every minute we make a query-check of the result
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);
}

Petunjuk

Instruksi API untuk Text to Speech

Contoh Integrasi

Opsi 1 - Pengisian suara cepat untuk teks pendek

Teks dikirim ke API, Anda mendapatkan hasil secara langsung.

Format Permintaan

Parameter Wajib:

Parameter Opsional:

Jawaban diterima dalam format JSON:

Deskripsi:

Contoh pengisian suara teks pendek dalam PHP opsi 1

Opsi 2 adalah pengaturan tugas pengisian suara untuk teks.

Url untuk opsi 2: https://speechgen.io/index.php?r=api/longtext

Format Permintaan

Parameter Wajib:

Parameter Opsional:

Jawaban diterima dalam format JSON:

Deskripsi:

Format Permintaan

Parameter Wajib:

Jawaban diterima dalam format JSON:

Deskripsi:

Contoh pengisian suara uji singkat dalam PHP opsi 2

Dukungan

Konten