Essence - Text to Speech

POST

/v1/text-to-speech/essence

Converte texto em fala usando o modelo essence com reconhecimento de emoções. Requer chave de API válida e créditos suficientes.
Retorna dados de áudio binários diretamente (não-streaming), mesmo formato do modelo Wave.

Fluxo de Processamento:

Valida chave de API e créditos

Gera áudio usando síntese de IA com reconhecimento de emoções

Rastreia uso e deduz créditos

Uso de Créditos:

1 crédito por caracter

Contagem de caracteres inclui todo o conteúdo do texto

Créditos são deduzidos após geração bem-sucedida do áudio

Recursos Especiais:

Geração de voz baseada em emoções

Inserção de pausas usando sintaxe <#x#> (x = segundos, 0.01-99.99)

Controle avançado de formato de áudio

Modo não-streaming (streaming não implementado)

Requisição

Authorization

API Key

Adicionar parâmetro em header

X-API-Key

Exemplo:

X-API-Key: ********************

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200OK

audio/mpeg

Áudio gerado com sucesso

Headers

Body

🟠400Bad Request

🟠401Unauthorized

🟠402402

🟠429429

🔴500Server Error

🔴502Bad Gateway

Request Example

Shell

JavaScript

Java

Swift

cURL

Solicitação TTS Essence simplesTTS Essence avançado com configurações personalizadas

curl --location --request POST 'https://api.speach.studio/v1/text-to-speech/essence' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text": "Olá, este é um teste do modelo Essence, focado em interpretação e sotaque.",
    "voice_setting": {
        "voice_id": "moss_audio_d02e56f1-7d37-11f0-b37e-7a4fb521fb55",
        "emotion": "happy"
    },
    "model_variant": "turbo"
}'

Response Example

400 - Erro de validação

{
    "error": "Validação falhou",
    "code": "VALIDATION_ERROR",
    "request_id": "req_123456789"
}

Modificado em 2025-09-01 21:52:57

Página anterior

Wave - Text to Speech

Próxima página

UnauthorizedError