Perguntas frequentes
O que é TTS e como funciona?
TTS (Text-to-Speech) converte texto em áudio. Você envia texto via API e recebe um arquivo de áudio. A API aceita POST JSON com campos como model, input e voice. O áudio é gerado na nuvem e retornado na resposta, pronto para ser integrado ao seu jogo.
Quais vozes são melhores para NPCs?
Escolha entre 8 presets: aria, nova, luna, sage (femininas) e felix, milo, atlas, orion (masculinas). Use atlas para notícias ou felix para promoções. Cada voz tem um tom distinto, ideal para diferentes personalidades de NPCs, sem necessidade de clonagem ou design personalizado.
Posso usar TTS em jogos comerciais?
Sim, não há restrições de uso comercial. O preço é $10 por 1 milhão de caracteres. Não há planos mensais ou taxas fixas. Você paga apenas pelo uso, com saldo que não expira. Ideal para jogos indie com orçamentos variáveis.
Qual o melhor formato de áudio para jogos?
Você pode escolher entre mp3, wav, opus, flac e pcm. Para jogos, mp3 ou opus são eficientes em tamanho. O formato é definido no campo response_format da requisição. A API retorna o arquivo diretamente no corpo da resposta HTTP.
Como lidar com textos longos em jogos?
O limite é 4096 caracteres por requisição. Para textos maiores, divida em partes, gere cada áudio e junte os arquivos. O tempo de geração é aproximadamente real-time. Requests são processados em fila, então longos textos podem levar mais tempo.
A API suporta múltiplos idiomas no mesmo jogo?
Sim, suporta 23 idiomas, incluindo inglês, português, espanhol e japonês. Você pode definir o campo language na requisição. Se não definido, o idioma é adivinhado pelo script. Todas as vozes podem falar qualquer idioma suportado.
Preciso de internet para usar o TTS?
Sim, a API é baseada na nuvem. Você precisa de conexão para enviar texto e receber o áudio. Não há SDK offline ou instalação local. O áudio gerado não é armazenado pela API após o envio.
O áudio gerado tem direitos autorais?
As vozes são baseadas em gravações licenciadas (LibriTTS-R CC BY 4.0 e LibriVox). O áudio gerado é retornado na resposta e não é armazenado.
Como integrar com Unity?
Use HTTP POST para https://api.wasp33.info/v1/audio/speech. Envie o texto e receba o áudio. Você pode usar bibliotecas padrão do Unity para fazer requisições HTTP. Não há SDK oficial, então use HTTP ou a SDK OpenAI com base_url alterada.
O custo é viável para jogos pequenos?
Sim, $0,01 por 1000 caracteres. Não há custo fixo mensal. O saldo não expira. Você pode começar com $0,50 de crédito gratuito ao se registrar com Google. Ideal para projetos com baixo volume de diálogos.
Posso alterar a entonação da voz?
Não há suporte para tags de emoção ou SSML. Você pode ajustar a velocidade (0.25–4.0) para mudar o ritmo. A entonação é fixa por voz. Não há personalização de emoções ou clonagem de voz disponível.
A API retorna metadados úteis?
A resposta retorna o áudio. Metadados como tempo, caracteres e status são mantidos para faturamento. Não há metadados ricos no áudio gerado, como marcações temporais detalhadas. Use o campo input para rastrear qual texto gerou qual áudio.
Existe limite de uso diário?
Não há limite diário fixo. O limite é de 60 requisições por minuto por chave. Antes do primeiro top-up, o limite é 10 por minuto. Não há limite de caracteres por dia, apenas por requisição (4096 chars).
Como garantir a privacidade do texto?
O texto é usado apenas para gerar o áudio e não é usado para treinamento. O áudio gerado não é armazenado. Metadados de uso são mantidos para faturamento. Não há compartilhamento de dados com terceiros mencionado.
A voz soa robótica?
As vozes são baseadas em gravações licenciadas e soam naturais. Há uma marca d'água inaudível que marca o áudio como sintético. A qualidade é comparável a outras APIs, sem claims de ser a 'mais realista'.
Posso usar a API offline?
Não, a API é baseada na nuvem. Todas as requisições são processadas nos servidores. Não há versão offline ou SDK local. Você precisa de conexão de internet para cada geração de áudio.
O que é água-marcada inaudível?
Cada arquivo de áudio gerado contém uma marca d'água inaudível que indica ser fala sintética. Isso ajuda a identificar o conteúdo como gerado por IA, sem afetar a qualidade de áudio percebida pelo jogador.
A API funciona em tempo real?
Não há streaming ou WebSocket. O áudio é gerado completo e retornado na resposta. Para textos longos, o tempo é aproximadamente real-time. Requests são processados em fila, então há latência sob carga. Não há áudio parcial.
Por que usar TTS para NPCs?
Gerar diálogos para NPCs tradicionalmente exige gravações estúdio caras ou bibliotecas de voz pré-gravadas limitadas. Com nossa API, você paga apenas pelo que usa, eliminando custos fixos de produção de áudio para cada nova linha de diálogo ou atualização de missão.
Redução de Custos
A estrutura de preço é simples: US$ 10 por 1 milhão de caracteres. Isso permite escalar o áudio do seu jogo sem surpresas em faturas mensais ou assinaturas obrigatórias.
Conteúdo Infinito
Como cada solicitação gera um arquivo de áudio único, você nunca fica sem linhas para seus personagens. Isso é ideal para jogos com diálogos dinâmicos ou traduções automáticas para até 23 idiomas.
Não há limite de caracteres por mês, apenas o limite de 4.096 caracteres por requisição. Textos maiores são divididos e unidos automaticamente, mantendo a fluidez da narrativa.
Personalização
Escolha entre 8 vozes distintas, desde a narradora Aria até o noticiário neutro de Atlas. Cada voz tem uma personalidade clara, facilitando a distinção entre diferentes NPCs sem necessidade de gravações adicionais.
A velocidade de fala é ajustável entre 0.25x e 4.0x, permitindo que você adapte a entrega para cutscenes lentas ou diálogos rápidos em batalhas.
Escolhendo a Voz Certa
Escolher a voz certa é crucial para imersão. Cada preset tem uma personalidade distinta, permitindo que NPCs soem consistentes sem exigir gravações manuais para cada linha.
Nossa biblioteca oferece oito opções baseadas em gravações licenciadas, garantindo qualidade profissional com custo acessível para desenvolvedores indie.
Aria para Narradores
Aria possui uma voz quente e clara, ideal para narrativas profundas. Ela é a escolha perfeita para missões que exigem contato emocional ou descrições detalhadas do mundo.
Use-a para diálogos de anciões ou guias que contam a história do jogo, mantendo a atenção do jogador.
- Voz feminina, quente e clara
- Ideal para narrativas e missões
- Baseada em gravações licenciadas
Atlas para Notícias
Atlas oferece um tom neutro e profissional, semelhante a locutores de notícias. Sua clareza garante que informações importantes sejam compreendidas rapidamente.
Perfeito para painéis informativos, atualizações de mercado ou diálogos diretos em jogos de estratégia.
- Voz masculina, neutra
- Tom jornalístico e direto
- Alta clareza na entrega
Felix para Promoções
Felix é energético e vibrante, ideal para vender itens ou anunciar eventos dentro do jogo. Sua energia atrai a atenção do jogador imediatamente.
Use-o para vendedores ambulantes ou anúncios de missões temporárias que exigem um tom mais animado.
- Voz masculina, energética
- Ideal para promoções e vendas
- Tom vibrante e chamativo
Implementação Técnica
A API aceita requisições HTTP padrão ou pode ser integrada via SDK da OpenAI, ajustando apenas o base_url para https://api.wasp33.info/v1. Isso permite reutilizar bibliotecas já conhecidas para enviar textos e receber arquivos de áudio instantaneamente.
Requisições HTTP
Envie um JSON para POST https://api.wasp33.info/v1/audio/speech com os campos model, input, voice e response_format. O endpoint retorna o arquivo de áudio diretamente na resposta, pronto para ser salvo ou reproduzido.
- Use
tts-1outts-1-hdpara o modelo. - Defina
voicecomoaria,nova,atlas, etc. - Especifique
response_formatcomo mp3, wav, opus, flac ou pcm.
SDK OpenAI
Configure o SDK OpenAI (Python, Node.js, etc.) apontando o base_url para https://api.wasp33.info/v1. Use o método audio.speech.create() com sua chave API, mantendo a mesma estrutura de parâmetros do padrão OpenAI.
Gerenciamento de Chaves
Cada conta possui uma chave ativa (tts-...) enviada no cabeçalho Authorization: Bearer. Você pode emitir uma nova chave a qualquer momento via painel, invalidando a anterior instantaneamente para garantir segurança sem interromper o fluxo de trabalho.
Otimização de Performance
Para jogos indie, a latência pode quebrar a imersão durante diálogos dinâmicos. O cache de áudio é essencial: armazene os arquivos gerados localmente ou em CDN para evitar novas requisições da API para frases repetidas de NPCs.
A pré-renderização de missões críticas permite que você gere e baixe o áudio antes do jogador iniciar a cena, eliminando o tempo de espera inicial. Isso garante que a experiência flua sem interrupções.
Cache de Áudio
Armazene os arquivos MP3 ou WAV gerados em uma pasta local ou CDN. Isso evita o overhead de latência de rede ao repetir diálogos comuns de NPCs, mantendo a responsividade do jogo.
- Armazene arquivos estáticos localmente ou em CDN.
- Evite latência de rede em diálogos repetidos.
- Reduz o uso de caracteres faturados para frases comuns.
Pré-renderização
Gere o áudio de missões críticas antes do jogador iniciar a cena. Isso elimina o tempo de espera inicial e garante que a experiência não seja interrompida pela fila de processamento da API.
- Gere áudio antes da cena iniciar.
- Elimina latência de carregamento inicial.
- Garante fluidez na narrativa.
Compressão de Formatos
Use MP3 para economizar espaço e banda, ou WAV para máxima qualidade sem perda. O formato FLAC oferece compressão sem perda, ideal para jogos que priorizam qualidade de áudio. PCM é útil para processamento em tempo real.
- MP3 para economia de espaço.
- WAV para qualidade sem perda.
- FLAC para compactação eficiente.
- PCM para processamento rápido.
Gestão de Texto
O limite de 4096 caracteres por requisição exige segmentação inteligente. O texto do diálogo deve ser dividido em partes menores e reunido sequencialmente para manter a fluidez narrativa.
Essa abordagem evita cortes abruptos e garante que frases longas sejam processadas corretamente, mantendo a imersão do jogador sem erros de síntese.
Quebra de Linhas
Divida o texto em sentenças completas antes de enviar à API. Isso evita que a voz corte palavras no meio da frase, preservando a entonação natural dos NPCs.
- Use quebras de sentença para segmentar o texto.
Limites de Caracteres
Cada chamada suporta até 4096 caracteres, incluindo espaços e pontuação. Textos maiores devem ser divididos e os arquivos de áudio resultantes unidos posteriormente.
- Máximo de 4096 caracteres por requisição.
Formatação
Mantenha a formatação simples. A API não interpreta tags HTML ou SSML, então use apenas texto puro. Caracteres especiais são contados no limite.
- Apenas texto plano é processado.
Idiomas e Locais
O suporte multilíngue é essencial para jogos indie que buscam audiência global. Nossa API oferece 23 idiomas, incluindo português, espanhol e japonês, permitindo que você localize seus NPCs sem contratar estúdios diferentes para cada região.
Todos os 8 presets de voz falam qualquer um dos idiomas disponíveis. Isso garante consistência tonal entre diálogos em diferentes línguas, mantendo a identidade do seu projeto sem complexidade adicional de gerenciamento de vozes.
Suporte Multilíngue
Oferecemos suporte para 23 idiomas, incluindo português, espanhol, japonês e coreano. Qualquer uma das 8 vozes pode falar qualquer idioma listado, garantindo flexibilidade na criação de diálogos multilíngues.
Idiomas não listados, como vietnamita ou tailandês, não são suportados. Verifique a lista completa para evitar erros de síntese em suas localizações.
- 23 idiomas suportados
- Todas as vozes falam todos os idiomas
- Inclui português, espanhol, japonês, coreano
Detecção Automática
Se o campo language não for definido, o sistema tenta adivinhar o idioma com base no script do texto. Para textos em latim, o padrão é inglês.
Essa detecção é útil para textos simples, mas pode falhar com misturas de idiomas ou acentos específicos.
Forçar Idioma
Para garantir precisão, sempre defina o parâmetro language com o código ISO correspondente. Isso evita que textos em português ou espanhol sejam pronunciados com sotaque inglês.
Exemplo: "language": "pt" garante a pronúncia correta para diálogos de NPCs brasileiros ou portugueses.
Custos em Produção
Para diálogos de NPCs, o custo é previsível: US$ 0,01 por mil caracteres. Um jogo com 10 horas de áudio gerado consome aproximadamente 10 milhões de caracteres, totalizando US$ 100. Cada caractere, incluindo espaços e pontuação, conta para a fatura.
O crédito inicial gratuito de US$ 0,50 (cerca de 50.000 caracteres) permite testar vozes sem custo, disponível apenas ao entrar com Google. Após o uso, recargas mínimas de US$ 5 via USDT (TRC-20) são processadas automaticamente.
Estimativa de Gasto
O preço é fixo: US$ 10 por milhão de caracteres. Requests falhas são gratuitas. A velocidade média é de 25 caracteres por segundo, então 1.000 caracteres geram áudio em cerca de 40 segundos.
- US$ 0,01 por 1.000 caracteres
- Espaços e pontuação contam como caracteres
- Falhas na síntese não cobram
Otimização de Caracteres
Remova tags de formatação desnecessárias antes de enviar à API. Reutilize áudios para frases repetidas (ex: saudações padrão) para não gastar crédito duas vezes.
- Limpe textos antes da requisição
- Cache de áudio para frases comuns
Crédito Inicial
Ao entrar com Google, receba US$ 0,50 válidos por 7 dias. Crie conta por e-mail e senha para começar sem crédito, mas com controle total.
- US$ 0,50 para testes
- Válido por 7 dias
- Recargas mínimas de US$ 5

Qualidade de Áudio
A escolha do formato de áudio impacta diretamente o tamanho do arquivo final e a latência no carregamento. O MP3 oferece compressão eficiente para diálogos rápidos, enquanto o WAV preserva a qualidade original, ideal para samples curtos em jogos indie que priorizam fidelidade sem considerar a economia de espaço.
MP3 vs WAV
Use MP3 para economizar espaço em disco, especialmente em jogos com muitos diálogos. O WAV é recomendado quando a qualidade bruta é essencial e o tamanho não é uma restrição crítica.
- MP3: melhor compressão, menor tamanho.
- WAV: qualidade intacta, arquivo maior.
Velocidade da Voz
Ajuste a velocidade entre 0.25 e 4.0 para adaptar o ritmo dos NPCs. Diálogos rápidos podem ser acelerados, enquanto narrações de missões beneficiam-se de uma velocidade mais calma para melhor compreensão.
- Intervalo: 0.25 a 4.0.
- Ajuste conforme o contexto da cena.
Clareza
As vozes são projetadas para clareza narrativa. Ajuste o idioma explicitamente se o texto não for em inglês para evitar detecção automática incorreta, garantindo que a pronúncia esteja correta para o público-alvo.
- Defina
languagepara textos não-ingleses. - Evite ambiguidades na pronúncia.
Integração em Engines
Integrar a API Wasp Voices em engines de jogos é direto, pois a estrutura de requisição segue o padrão OpenAI. Isso permite usar SDKs conhecidos ou chamadas HTTP simples para gerar áudio de NPCs em tempo de execução ou durante o carregamento.
O fluxo básico envolve enviar o texto do diálogo via POST para o endpoint de speech, receber o arquivo de áudio e carregá-lo no motor. Como os formatos são padrão (mp3, wav, opus), a compatibilidade é garantida na maioria dos engines modernos.
Unity
No Unity, você pode usar a classe UnityWebRequest para enviar o texto e baixar o áudio. O formato WAV é recomendado para evitar overhead de decodificação em tempo real, enquanto o MP3 economiza espaço de armazenamento no build final.
Armazene as chaves da API como variáveis de script ou em um arquivo de configuração seguro. Para diálogos longos, considere pré-renderizar frases comuns para evitar latência durante a gameplay.
- Use
UnityWebRequest.Postpara requisições assíncronas. - Prefira WAV para streaming imediato no Unity.
- Cache vozes comuns para evitar chamadas de rede.
Unreal Engine
No Unreal Engine 5, utilize FHttpModule ou bibliotecas como RestClient para comunicar-se com a API. O motor suporta nativamente a reprodução de arquivos WAV e MP3 via AudioComponent, facilitando a integração de diálogos gerados dinamicamente.
Devido ao limite de 4096 caracteres, divida diálogos longos em chunks menores antes de enviar. O resultado pode ser armazenado em memória ou no disco para reutilização, otimizando o uso da API.
- Utilize
FHttpModulepara chamadas HTTP. - Suporte nativo a WAV/MP3 em
AudioComponent. - Divida textos longos antes da requisição.
Godot
No Godot, a classe HTTPClient permite enviar requisições POST de forma simples. Você pode salvar o áudio retornado como um arquivo .mp3 ou .wav e carregá-lo usando AudioStreamPlayer para reprodução instantânea nos diálogos dos NPCs.
Como o Godot é leve e open-source, a integração via HTTP é eficiente. Certifique-se de gerenciar o ciclo de vida dos players de áudio para evitar vazamentos de memória durante sessões longas de jogo.
- Use
HTTPClientpara comunicação com a API. - Salve áudio como arquivos locais ou em memória.
- Use
AudioStreamPlayerpara reprodução simples.
Casos de Uso
O TTS permite gerar diálogos dinâmicos para NPCs, adaptando o conteúdo sem a necessidade de estúdios de gravação caros. Isso é ideal para jogos com grandes quantidades de texto.
A economia de custos e a facilidade de integração tornam o TTS uma escolha prática para desenvolvedores indie que buscam qualidade sonora sem complexidade.
Jogos de RPG
Gere milhares de linhas de diálogo para personagens secundários sem limite criativo. Use vozes distintas para dar personalidade a cada NPC, mantendo a consistência da narrativa.
Com o limite de 4096 caracteres por solicitação, textos longos são divididos automaticamente. Isso permite missões extensas sem perder a clareza do áudio gerado.
- Vozes como Luna (soft, storytelling) para narrativas imersivas.
- Suporte a idiomas como Inglês, Português e Japonês para jogos multilingues.
Jogos de Aventura
Use vozes energéticas como Felix para missões de promoção ou descoberta. A velocidade ajustável (0.25–4.0) permite sincronizar a fala com a ação do jogador.
O formato MP3 ou Opus reduz o tamanho do arquivo, facilitando o carregamento em dispositivos com limitações de armazenamento.
- Cache de áudio para evitar regeneração desnecessária.
- Controle de velocidade para ajustar o ritmo da aventura.
Jogos Narrativos
Narrações imersivas com vozes como Aria ou Sage garantem clareza e tom adequado. O áudio gerado é marcado com watermark invisível, identificando-o como sintetizado.
Ideal para jogos focados em história, onde cada palavra conta. A precisão da linguagem é mantida com a detecção automática ou forçada de idioma.
- Vozes calmantes para narrativa relaxante.
- Suporte a 23 idiomas para alcance global.
Limitações Conhecidas
Antes de integrar nossa API no pipeline de áudio do seu jogo, é importante conhecer as limitações técnicas para evitar surpresas durante o desenvolvimento. O sistema foi projetado para ser direto e previsível, o que significa que algumas funcionalidades avançadas de síntese de voz não estão disponíveis.
Essas restrições são intencionais para manter a simplicidade da API e o custo acessível para estúdios indie. Conheça cada limitação para ajustar seu workflow de produção.
Sem SSML
Nossa API não processa marcações SSML (Speech Synthesis Markup Language). Isso significa que você não pode controlar pausas, ênfase ou prosódia diretamente pelo texto enviado na requisição. O áudio é gerado com entonação padrão baseada na voz escolhida.
Sem Clonagem
Não oferecemos clonagem de voz personalizada. Você deve escolher entre as 8 vozes predefinidas (como Aria, Atlas ou Felix). Não é possível enviar um arquivo de áudio para criar uma voz única ou personalizada para seu jogo.
Sem Streaming
A geração de áudio não é transmitida em tempo real via WebSocket. Você envia o texto e recebe o arquivo de áudio completo após o processamento. Para diálogos longos, recomendamos dividir o texto em partes menores para melhor gestão do fluxo.
Suporte e FAQ
O suporte técnico é realizado exclusivamente por email. Não oferecemos telefone, chat ao vivo nem SLA de tempo de resposta. Para dúvidas sobre chaves, limites ou erros de integração, escreva diretamente para nossa equipe.
Contato por Email
Envie suas dúvidas técnicas ou de conta para nosso endereço de suporte. Responderemos o mais rápido possível, sem promessas de tempo garantido.
Documentação Completa
Toda a referência da API, exemplos de código em Python e cURL, e a lista de vozes estão disponíveis na seção de documentação. Consulte a URL /docs/ para guias de integração passo a passo.
Comunidade
Não mantemos uma comunidade própria formal, mas incentivamos o uso de tags específicas para facilitar buscas.
Ouça as 8 vozes
Cada amostra abaixo foi gerada por esta API a partir da mesma frase. A variação mantém o jogador engajado e imerso na narrativa do jogo.
23 idiomas
Qualquer voz fala qualquer um desses idiomas.
