Instrucció de l'API per a Text a Parla

02-03-2024 , 02-03-2024

L'API està disponible només després d'haver finançat el vostre compte.

Veus de l'API JSON https://speechgen.io/index.php?r=api/voices.

Hi ha 2 opcions de veu en off de text disponibles a través de l'API:

1a opció - veu en off ràpida de textos curts.
2a opció - establir una tasca de veu en off.

Exemples d'integració

Descobreix com optimitzar la creació de contingut de veu integrant SpeechGen.io amb el servei d'automatització MAKE. Aquesta guia cobreix l'automatització dels processos de text a parla, fent-ho més senzill i eficient generar contingut de veu per a diverses aplicacions.

1a opció - veu en off ràpida de textos curts

Url per a la variant 1: https://speechgen.io/index.php?r=api/text

El text s'envia a l'API, obteniu resultats immediats.

Aquesta opció té un límit màxim de 2000 caràcters. I també un màxim de 2 canvis de veu. Si es superen els límits, obtindreu un error (estat = -1).

Format de la sol·licitud

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

Paràmetres obligatoris:

'token' - 'SekretKeyInYourProfile' 'email' - 'yourMail@gmail.com' 'voice' - 'Veu' 'text' - 'Text per a text a parla'

Paràmetres opcionals:

'format' - format del fitxer resultant, per defecte = mp3, valors possibles ( 'mp3', 'wav', 'ogg') 'speed' - velocitat de reproducció, per defecte 1, (rang de 0.1 a 2.0) 'pitch'- to de veu, per defecte 0, (rang de -20 a 20) 'emotion' - emoció de la veu , per defecte 'bo', valors possibles ( 'bo', 'dolent', 'neutre'). 'pause_sentence' - La mida de la pausa entre frases en mil·lisegons. 'pause_paragraph' - La mida de la pausa entre paràgrafs en mil·lisegons. 'bitrate'=>48000 - Bitrate de 8000 a 192000 Hz.

Emoció No disponible per a totes les veus, mireu-ho aquí.

La resposta ve en 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" }

Descripció:

"id" - ID de veu únic "status" - estat actual de la veu en off. Disponible de 3 valors: 0 - procés 1 - completat amb èxit -1 - error "file" - camí del fitxer d'àudio, disponible si l'estat= 1 "file_cors" - camí del fitxer d'àudio CORS "error" - text de l'error, en el cas de, si l'estat = -1 "parts" - nombre de veus en off "parts_done" - nombre de peces completades "duration" - durada del fitxer d'àudio en segons, disponible si l'estat = 1 "format" - format del fitxer d'àudio "balans" - balanç del límit "cost" - costos de la veu en off. (s'incrementa a mesura que les parts de la veu són doblades)

La 2a opció és establir una tasca de veu en off per al text.

Url per a la opció 2: https://speechgen.io/index.php?r=api/longtext

Pas 1: El text s'envia a l'API i s'obté un ID de veu únic(id).
Pas 2:  Sol·liciteu el resultat del doblatge enviant l'identificador de doblatge (id).

Aquest mètode no té limitacions i permet el doblatge de textos de fins a 1.000.000 de caràcters. El doblatge es realitza per ordre de prioritat (el primer que arriba, el primer que es serveix) i pot trigar d'1 a diversos minuts, depenent de la longitud del text.

Format de la sol·licitud

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

Paràmetres obligatoris:

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

Paràmetres opcionals:

'format' - format del fitxer resultant, per defecte = mp3, valors possibles( 'mp3', 'wav', 'ogg') 'speed' - velocitat, per defecte 1, (rang de 0.1 a 2.0) 'pitch'- to de veu, per defecte 0, (rang de -20 a 20) 'emotion' - coloració emocional, per defecte 'bo', valors possibles ( 'bo', 'dolent', 'neutre'). 'pause_sentence' - La mida de la pausa entre frases en mil·lisegons. 'pause_paragraph' - La mida de la pausa entre paràgrafs en mil·lisegons. 'bitrate'=>48000 - Bitrate de 8000 a 192000 Hz.

No disponible per a totes les veus, mireu aquí.

La resposta ve en JSON:

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

Descripció:

"id" - ID de veu únic "status" - estat actual de la veu en off. Disponible de 2 valors: 1 - tasca afegida amb èxit -1 - error "error" - text de l'error, en cas de, si l'estat = -1 "parts" - nombre de veus en off "parts_done" - nombre de peces completades "format" - format del fitxer d'àudio "balans" - el balanç dels límits del compte "cost" - costos de la veu en off. (s'incrementa a mesura que les parts de la veu són doblades)

Pas 2. Després de crear una tasca i obtenir un identificador (id), s'ha d'enviar una sol·licitud a https://speechgen.io/index.php?r=api/result, per saber el resultat.

Format de la sol·licitud

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

Paràmetres obligatoris:

'token' - SekretKeyInYourProfile 'email' - yourMail@gmail.com 'id' - ID de veu únic obtingut en el pas 1

La resposta ve en 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" }

Descripció:

"id" - ID de veu únic "status" - estat actual de la veu en off. Disponible de 3 valors: 0 - en mig de 1 - completat amb èxit -1 - error "file" - camí del fitxer d'àudio, disponible si l'estat = 1 "error" - text de l'error, en cas de, si l'estat = -1 "parts" - nombre de veus en off "parts_done" - nombre de peces completades "duration" - durada del fitxer d'àudio en segons, disponible si l'estat = 1 "format" - format del fitxer d'àudio "balans" - el balanç dels límits del compte "cost" - costos de la veu en off. (s'incrementa a mesura que les parts de la veu són doblades) "cuts" - Array de fragments, si s'utilitza l'etiqueta "cut" en el text