A API

A tecnologia utilizada na API do TTSgo permite a rápida implementação de aplicações que precisam transformar texto em voz.

Após criar sua conta no TTSgo, escolher o pacote que deseja contratar (partindo de R$ 0,00 por mês), você terá acesso a sua API Key, necessária para consumir o serviço de Text to Speech (Texto para Voz).

Para usar a API, é preciso fazer um request tipo GET para a seguinte URL


Passando os seguintes parâmetros

Nome Obrigatório Default Exemplo
text Sim - Olá Mundo
api_key Sim - 45481df5sf54535r14r53
voz Não masculina feminina

Exemplo de request



Exemplo de JSON de retorno
   
    
    {
        "status":"OK",
        "url":"https://admin.ttsgo.com.br/download/4dasfas545345626dfga5ga6645.wav"
    }
    

Todas as respostas da API devolvem uma string JSON. Se o request tiver successo, você vai obter um JSON como o de acima. Se o request falhar, você receberá uma reposta como a seguinte:
    
    
    {
        "status":"ERROR",
        "message":"Text is missing"
    }
    

Exemplo de como utilizar a API em PHP


<?php
//Armazena a URL base em uma variável
$url = 'https://admin.ttsgo.com.br/api/textToSpeech';

//Armazena o texto a ser transformado em voz em uma variável
$texto = 'Que legal poder ouvir meu texto!';

//Transforma os espaços em branco para o formato aceito nas requisições HTTP
$texto = str_replace(' ', '%20', $texto);

//Armazena a voz a ser utilizada em uma variável
$voz = 'feminina';

//Armazena a API Key em uma variável
$api_key = 'Coloque aqui sua API Key';

//Faz a requisição à API utilizando as funções curl do PHP
$ch = curl_init();
//Caso tenha dificuldade com a requisição via HTTPS, descomente a linha abaixo
//curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
curl_setopt($ch, CURLOPT_URL, "$url?text=$texto&api_key=$api_key&voz=$voz");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$retorno = curl_exec($ch);

//Decodifica a string JSON retornada e a armazena no objeto $objJson
$objJson = json_decode($retorno);

//Abre um arquivo para gravar o áudio gerado
$fp = fopen('audio.wav','w');

//Escreve no arquivo aberto o audio gerado pelo TTSgo
fwrite($fp, file_get_contents($objJson->url));
//Fecha o arquivo
fclose($fp);


//No mesmo diretório/pasta onde está o código PHP é gerado 
//um arquivo chamado audio.wav com o áudio gerado pelo TTSgo
?>

Exemplo de como utilizar a API em Python


import urllib2
import json
import requests

#Armazena a URL base em uma variavel
url = 'https://admin.ttsgo.com.br/api/textToSpeech'

#Armazena o texto a ser transformado em voz em uma variavel
texto = 'Que legal poder ouvir meu texto!'

#Armazena a voz a ser utilizada em uma variavel
voz = 'feminina'

#Armazena a API Key em uma variavel
api_key = 'Coloque aqui sua API Key'

#Faz a requisicao para a API
r = requests.get(url + '?text=' + texto + '&voz=' + voz + '&api_key=' + api_key)

#Tranforma o retorno em um objeto JSON
json_parsed = json.loads(r.text)

#Faz o download do audio
u = urllib2.urlopen(json_parsed['url'])

#Grava o audio em um arquivo 
f = open('audio.wav', 'wb')
meta = u.info()
file_size = int(meta.getheaders('Content-Length')[0])
file_size_dl = 0
block_sz = 8192

while True:
    buffer = u.read(block_sz)
    if not buffer:
        break
    file_size_dl += len(buffer)
    f.write(buffer)
 
f.close()

#Um arquivo chamado audio.wav contendo o audio baixado
#eh criado no mesmo diretorio/pasta onde on codigo 
#Python esta