Perguntas frequentes
Qual a melhor voz para apps de leitura?
Não há uma única melhor voz, pois depende do contexto do seu app. Para narrativas, Luna (suave) ou Sage (calmo) são opções. Para leitura informativa, Atlas (neutro) ou Felix (energético) funcionam bem. Todas as 8 vozes suportam os 23 idiomas disponíveis, permitindo que você escolha a que melhor se adapta ao tom da sua aplicação.
Como escolher entre MP3 e OPUS?
Escolha MP3 para máxima compatibilidade com players de áudio antigos e navegadores simples. Opte por OPUS se priorizar eficiência de banda e qualidade em redes móveis, pois oferece melhor compressão. Ambos são formatos válidos na API. O WAV é ideal para edição posterior, enquanto FLAC garante perda zero de qualidade para arquivamento.
Preciso de um backend para usar a API?
Não é obrigatório, mas recomendado. Você pode chamar a API diretamente do frontend, mas deve expor sua chave Bearer. Para maior segurança, use um backend intermediário que armazene a chave e faça as requisições, evitando que desenvolvedores descubram suas credenciais. A API aceita requisições JSON padrão via POST.
Como evitar o limite de 60 requests?
O limite é de 60 requisições por minuto por chave. Para volumes maiores, implemente lógica de fila no seu app ou backend para espaçar as chamadas. Você pode emitir uma nova chave a qualquer momento, o que invalida a anterior instantaneamente, permitindo criar novas chaves para escalar, respeitando o limite por chave.
A API funciona em apps híbridos?
Sim. Como a API é HTTP/JSON padrão, funciona perfeitamente em frameworks híbridos como React Native, Flutter ou Ionic. Basta configurar o cliente HTTP da sua aplicação para enviar o POST para o endpoint da API, passando a chave de autenticação e os parâmetros de texto e voz desejados.
Qual o tamanho ideal de texto por request?
O limite técnico é de 4096 caracteres por solicitação. Para textos longos, divida o conteúdo em partes menores e junte os arquivos de áudio resultantes. Isso garante que cada requisição seja processada eficientemente. Caracteres incluem espaços e pontuação, então planeje a divisão do seu conteúdo com antecedência.
Posso mudar a velocidade da voz?
Sim, você pode ajustar a velocidade entre 0.25 e 4.0. Isso permite acelerar narrações rápidas ou desacelerar para maior clareza. O parâmetro 'speed' é enviado no corpo JSON da requisição. A qualidade da voz permanece consistente independentemente da velocidade ajustada, mantendo a naturalidade do áudio gerado.
A API suporta idiomas latinos?
Sim, suporta 23 idiomas, incluindo português, espanhol, francês e italiano. Se o texto estiver em latim mas não for inglês, defina o parâmetro 'language' explicitamente. Caso contrário, o sistema assume inglês para textos em script latino. Verifique a lista completa de idiomas suportados na documentação para garantir a compatibilidade.
Como testar a API sem pagar?
Registre-se com Google para receber $0,50 de crédito gratuito, válido por 7 dias. Isso equivale a cerca de 50.000 caracteres. Contas criadas com email e senha não recebem esse crédito inicial. Use esse saldo para testar vozes, formatos e velocidades sem precisar realizar um depósito imediato via USDT.
O que é o trial de $0,50?
É um crédito inicial de $0,50 concedido ao se registrar com o Google. Válido por 7 dias, permite gerar cerca de 50.000 caracteres. É ideal para testes rápidos. Não é necessário cartão de crédito. Se o saldo acabar, você pode fazer top-up via USDT na rede TRON para continuar usando.
Posso usar a API em projetos comerciais?
Sim, não há restrições de uso para projetos comerciais. Você paga apenas pelo volume de caracteres consumidos, sem planos mensais ou custos fixos. O áudio gerado não é armazenado e não é usado para treinamento. A única marca d'água é inaudível, indicando que é fala sintética, conforme especificado.
A API é adequada para games?
Sim, para narração de missões, diálogos curtos ou audiobooks integrados. A latência é de aproximadamente 25 caracteres por segundo para textos longos, mas frases curtas podem levar alguns segundos devido à fila. Para jogos em tempo real, considere pré-generar os áudios ou usar cache, pois não há streaming de áudio.
Como lidar com textos longos?
Divida o texto em partes de até 4096 caracteres. Envie cada parte via API e receba os arquivos de áudio individuais. No seu aplicativo, reproduza esses arquivos sequencialmente para criar a narrativa completa. Isso evita erros de limite e garante que cada trecho seja processado corretamente pela engine de TTS.
A API tem suporte a SSML?
Não. A API não suporta SSML, nem dicionários de fonemas ou lexicons de pronúncia personalizada. Você envia texto simples. Se precisar de pausas ou ênfases específicas, ajuste a velocidade ou escolha a voz mais adequada. Não há tags de emoção ou controle granular de entonação via markup.
Posso usar a API offline?
Não. A API é baseada em nuvem. Você precisa de conexão à internet para enviar o texto e receber o arquivo de áudio. Os arquivos gerados podem ser armazenados localmente no dispositivo do usuário após o download, mas a síntese ocorre nos servidores da AppVoz API remotamente.
Qual a latência média?
Textos longos são gerados em tempo real aproximado (25 caracteres/segundo). Frases curtas levam alguns segundos devido ao processamento. Sob carga, as requisições podem entrar em fila. Não há garantia de SLA ou uptime. Para apps sensíveis a latência, considere pré-processar o áudio ou usar cache local.
A API é escalável para muitos usuários?
Sim, através do uso de múltiplas chaves API. Como cada chave tem limite de 60 requests/min, você pode distribuir a carga criando novas chaves. O saldo não expira e não há limite de contas. Isso permite escalar horizontalmente conforme o número de usuários do seu app aumenta.
Como proteger minha API key?
Armazene a chave em variáveis de ambiente ou no backend. Se usar no frontend, saiba que ela será visível. Você pode emitir uma nova chave a qualquer momento, invalidando a anterior instantaneamente. Use essa funcionalidade para revogar chaves comprometidas sem precisar redefinir a senha da conta.
A API funciona em iOS e Android?
Sim. Como é uma API RESTful HTTP, funciona em qualquer plataforma que suporte requisições de rede. Use bibliotecas HTTP nativas ou frameworks cross-platform para integrar. Basta configurar o endpoint correto e passar a chave Bearer. Não há SDK específico para iOS ou Android, apenas integração via HTTP.
Preciso de desenvolvedor para integrar?
Recomendado. A integração requer conhecimento de HTTP, JSON e autenticação Bearer. Embora a estrutura seja similar à OpenAI, você precisa gerenciar a divisão de textos longos, filas e armazenamento de áudio. Para apps complexos, um desenvolvedor garante uma integração robusta, manejo de erros e otimização de custos.
Escolhendo a tecnologia
Para aplicativos mobile, a API em nuvem elimina a necessidade de hardware dedicado para síntese de voz. Você envia o texto e recebe o áudio, mantendo o app leve e permitindo escalabilidade sem investir em servidores locais.
Escolha a implementação que melhor se adapta à sua stack. O SDK OpenAI oferece conveniência para projetos existentes, enquanto o HTTP simples garante máxima compatibilidade com qualquer linguagem de programação mobile.
API vs Local
Usar a API em nuvem evita o consumo de bateria e CPU do dispositivo durante a geração. O processamento ocorre nos nossos servidores, e você recebe apenas o arquivo de áudio final via POST. Isso libera recursos do app para outras tarefas críticas.
Não há necessidade de empacotar grandes modelos de voz no app. Você paga apenas pelo que usar, com custo de $0,01 por mil caracteres, ideal para orçamentos de freelancers.
SDK OpenAI
Se você já utiliza o ecossistema OpenAI, pode reutilizar suas bibliotecas. Basta alterar o base_url para https://api.playqq1.com/v1 e usar sua chave de API (tts-...). A estrutura de requisição é idêntica à da OpenAI, facilitando a migração.
Isso reduz o tempo de desenvolvimento, pois você não precisa escrever código HTTP personalizado do zero para autenticação e serialização de JSON.
HTTP simples
Para linguagens sem SDK dedicado ou para máxima leveza, envie uma requisição POST padrão. O endpoint aceita JSON com os campos model, input, voice e response_format. A resposta contém o áudio diretamente.
Esta abordagem oferece controle total sobre a camada de rede, permitindo otimizações específicas para diferentes plataformas móveis, como Android ou iOS.
Configuração inicial
Para começar, acesse /get-api-key/ e crie sua conta usando Google ou e-mail. Isso garante uma base técnica pronta para integração. A criação é imediata e não exige configurações complexas de servidor.
Com a conta ativa, você terá acesso à interface de controle onde a chave de API e o saldo estão disponíveis.
Criação de conta
Acesse a página de criação de conta e escolha entre login com Google ou e-mail. O processo é rápido e cria um perfil técnico específico para o seu projeto mobile.
Obtenção da chave
Após o login, copie sua chave API única (formato tts-...). Ela é necessária para autenticar todas as chamadas. Você pode gerar uma nova a qualquer momento, invalidando a anterior instantaneamente.
- Formato: Bearer tts-...
- Uma chave ativa por conta
- Invalidação instantânea ao gerar nova
Primeiro request
Envie um POST para https://api.playqq1.com/v1/audio/speech com seu texto e a chave no header Authorization. Receba o arquivo de áudio diretamente na resposta para integrar ao seu app.
Primeiro request
Utilize o SDK OpenAI ou HTTP simples, alterando o base_url. Teste com frases curtas para validar a latência e o formato de áudio antes de escalar para narrativas longas.
Seleção de vozes
Escolher a voz certa impacta diretamente na retenção do usuário. A API oferece oito vozes pré-definidas, geradas a partir de gravações licenciadas, prontas para uso imediato sem necessidade de treinamento ou clonagem personalizada.
Vozes femininas
Aria entrega uma narração clara e quente, ideal para livros e audiobooks. Nova é ótima para conteúdos dinâmicos e redes sociais, enquanto Luna traz suavidade para histórias. Sage é a escolha técnica para instruções passo a passo.
- Aria: narrativa, clara
- Nova: energética
- Luna: suave
- Sage: instrucional
Vozes masculinas
Felix é perfeito para promoções e anúncios curtos. Milo oferece uma conversa natural, ideal para chatbots. Atlas transmite neutralidade para notícias, e Orion adiciona profundidade a documentários e narrativas longas.
- Felix: promocional
- Milo: conversacional
- Atlas: neutro
- Orion: documental
Tom de voz
Cada voz possui uma característica única definida na criação. Não há tags de emoção ou ajuste fino de tom em tempo real. Selecione a preset que melhor se adapta ao contexto do seu app para garantir consistência.
Formatos de áudio
O formato de áudio determina como o arquivo será transmitido e reproduzido no dispositivo. A escolha impacta diretamente a largura de banda consumida, o tempo de carregamento e a qualidade percebida pelo usuário final.
MP3 universal
O MP3 é a opção padrão e mais segura para compatibilidade. Ele garante reprodução imediata em qualquer navegador ou player de áudio nativo, sem necessidade de codecs adicionais. Ideal para garantir que o conteúdo seja acessível em todos os dispositivos móveis, desde versões mais antigas do Android até iOS.
OPUS leve
O formato OPUS é recomendado para aplicações móveis que priorizam o baixo consumo de dados. Ele proporciona excelente qualidade de áudio com bitrates menores que o MP3, sendo útil para apps com limitações de banda ou usuários em redes móveis.
FLAC qualidade
Para projetos que exigem fidelidade máxima, o FLAC oferece áudio lossless. Embora ocupe mais espaço e banda, é uma opção para audiobooks ou conteúdos onde a nuance da voz sintética deve ser preservada integralmente sem compressão.
Gerenciamento de texto
A API aceita no máximo 4096 caracteres por requisição. Para textos longos, o aplicativo deve dividir o conteúdo em partes menores antes de enviar cada lote para o endpoint de síntese.
Essa limitação exige que o desenvolvedor gerencie o fluxo de dados localmente, garantindo que cada fragmento respeite o limite máximo para evitar falhas silenciosas ou cortes abruptos no áudio gerado.
Split de texto
Divida o texto em chunks de até 4096 caracteres. O limite conta espaços e pontuação. Envie cada parte individualmente via POST para garantir que a síntese seja processada corretamente sem estourar o tamanho máximo permitido pela API.
Não há suporte para SSML, então quebras de parágrafo ou ênfases devem ser manipuladas manualmente no texto enviado.
- Limite máximo: 4096 caracteres por requisição.
- Espaços e pontuação contam como caracteres.
- Envie cada chunk via endpoint POST separado.
Juntar arquivos
Receba cada arquivo de áudio gerado e armazene-os temporariamente na memória ou cache local. Após receber todas as respostas da API, concatene os arquivos na ordem correta para formar o áudio final contínuo.
O tempo de geração é aproximadamente em tempo real. Para textos longos, considere processar os chunks em paralelo se a lógica do seu app permitir, mas respeite o limite de 60 requisições por minuto por chave.
Controle de caracteres
Monitore a contagem de caracteres antes de enviar para evitar erros de validação. O preço é calculado por caractere, então espaços extras aumentam o custo sem benefício audible. Trim trailing spaces para otimizar.
Use a função de contagem do seu linguagem de programação para verificar o tamanho exato do string antes da chamada API, garantindo que nenhum chunk exceda o limite de 4096 caracteres.
Tratamento de erros
O tratamento de erros robusto é essencial para manter a experiência do usuário fluida durante a narração. Ao integrar a API, seu app deve lidar com falhas de rede e limites de taxa sem travar a interface principal.
Retry logic
Implemente uma lógica de retry exponencial para requisições falhas. Se a síntese falhar, a cobrança é devolvida integralmente, mas o erro pode ser transitório. Aguarde entre tentativas para evitar sobrecarga.
- Tente novamente após 1s, 2s, 4s em caso de falha temporária.
Rate limits
O limite é de 60 requisições por minuto por chave. Antes do primeiro top-up, são apenas 10 por minuto. Monitore o cabeçalho de resposta para evitar erros 429 e pausar brevemente as gerações.
- Limite padrão: 60 req/min. Limite inicial: 10 req/min.
Falhas de rede
Em caso de perda de conexão, o app deve armazenar localmente o texto a ser narrado. Ao recuperar a conexão, reenvie a requisição. O sistema garante que requisições com falha não sejam cobradas.
Otimização de custos
Reduzir chamadas desnecessárias é essencial para quem desenvolve apps móveis com orçamento limitado. A API cobra por caractere, então cada caractere economizado conta diretamente no saldo final.
Pré-generação
Antecipe a geração de áudio para textos estáticos, como instruções fixas ou menus. Gere esses arquivos em segundo plano durante o carregamento do app e armazene-os localmente. Isso elimina latência de rede para o usuário e evita o custo de processamento em tempo real para conteúdo que não muda.
Cache de frases
Armazene em cache as respostas de áudio já geradas. Se um usuário ouvir a mesma frase de instruções várias vezes, reutilize o arquivo gerado anteriormente. Isso evita o envio de novos requests para a API, economizando caracteres e mantendo a experiência fluida.
Uso eficiente do trial
O crédito inicial de $0,50 (cerca de 50.000 caracteres) expira em 7 dias. Use esse período para testes técnicos rápidos de integração, não para produção. Crie uma conta com email e senha se preferir, mas saiba que o trial não é concedido nesse método.

Experiência do usuário
O carregamento de áudio deve ser perceptível mas não intrusivo. Como a síntese pode levar segundos para frases curtas e mais tempo para textos longos, use indicadores de progresso claros. Não prometa instantaneidade absoluta, pois as requisições são processadas em fila sob carga.
A velocidade de reprodução é ajustável via API (0.25x a 4.0x). Permita que o usuário controle essa velocidade no player do app. Isso melhora a compreensão e personaliza a experiência de escuta, compensando a latência inicial da geração.
Loading states
Exiba um spinner ou barra de progresso enquanto a API processa o texto. Indique que o áudio está sendo gerado, não apenas baixado. Para textos longos, estime o tempo baseado na taxa de ~25 caracteres por segundo.
Controle de velocidade
Ofereça controles de playback que permitam alterar a velocidade entre 0.25x e 4.0x. Isso é crucial para usuários que preferem ouvir mais rápido ou mais devagar, especialmente em conteúdos densos ou para aprendizes de idiomas.
Acessibilidade
Certifique-se de que o player de áudio seja compatível com leitores de tela. Os arquivos gerados contêm uma marca d'água inaudível, o que não interfere na acessibilidade auditiva, mas garanta que os metadados do arquivo sejam legíveis.
Testes e QA
Testes em diferentes idiomas garantem que a API reconheça corretamente os 23 idiomas suportados, como português, espanhol ou japonês. Para textos em latim não ingleses, defina o parâmetro language explicitamente para evitar ambiguidades na geração. Valide a pronúncia de nomes próprios e termos técnicos específicos do seu app em cada língua disponível.
A validação de formato verifica se o áudio retornado corresponde ao solicitado (mp3, wav, opus, flac, pcm). Certifique-se de que o player do app mobile consegue reproduzir o arquivo diretamente da resposta JSON sem conversão adicional. Teste também a integração do SDK OpenAI ajustando o base_url para https://api.playqq1.com/v1.
Testes em diferentes idiomas
Verifique a pronúncia de palavras-chave em cada um dos 23 idiomas suportados. Use o parâmetro language para textos em scripts latinos que não sejam inglês, garantindo a precisão da síntese.
Teste limites de caracteres (4096) em textos longos para assegurar que o split manual funciona corretamente sem cortes abruptos na narrativa.
- Validar 23 idiomas listados
- Testar parâmetro
languageexplícito - Verificar split de texto longo
Validação de formato
Confirme que os arquivos gerados (mp3, wav, opus, flac, pcm) são reproduzíveis no player padrão do dispositivo móvel.
Garanta que a resposta da API contém o áudio binário ou link válido, conforme especificado no campo response_format.
- Testar mp3, wav, opus, flac, pcm
- Verificar reprodução no player nativo
- Validar resposta da API
Perfomance em devices
Meça o tempo de resposta para frases curtas (alguns segundos) e longas (tempo real). Considere filas de processamento sob carga.
Teste a integração em diferentes sistemas operacionais (iOS, Android) para garantir compatibilidade com os formatos de áudio suportados.
- Medir latência de resposta
- Testar iOS e Android
- Verificar compatibilidade de formatos
Deploy e monitoramento
Para garantir a estabilidade do seu app, monitore o saldo da API em tempo real. O painel de controle exibe o saldo atual, o crédito de teste restante e os caracteres consumidos, permitindo que você antecipe a necessidade de recarga via USDT na rede TRON antes que as requisições sejam interrompidas.
Monitoramento de saldo
A página de conta exibe o saldo atual, o crédito de teste restante e os caracteres consumidos. Isso permite antecipar a necessidade de recarga via USDT na rede TRON antes que as requisições sejam interrompidas.
Logs de requisição
Mantenha registros de tempo, tamanho e status de cada chamada para auditoria de cobrança. Esses metadados são retidos apenas para fins de faturamento e não incluem o texto original ou o áudio gerado.
Alertas de falha
Configure notificações para limites de taxa ou falhas de rede. Como não há garantia de SLA, monitore as filas de processamento para ajustar a experiência do usuário durante picos de demanda.
Casos de uso específicos
Integrar narração automática em apps mobile exige equilíbrio entre latência e qualidade. A API AppVoz oferece vozes naturais que podem ser pré-carregadas ou geradas sob demanda, adaptando-se ao fluxo de leitura do usuário sem interrupções visíveis.
Apps de leitura
Para leitores de texto, use a voz 'sage' para conteúdo instrucional ou 'aria' para narrativas. Gere áudios em segundo plano durante a rolagem do texto, garantindo que o áudio esteja pronto antes do usuário tocar no botão de reprodução.
- Use 'tts-1' para economia e 'tts-1-hd' para audiobooks premium.
- Cache localmente os arquivos MP3 de capítulos curtos para evitar requisições repetidas.
Jogos narrativos
Diálogos curtos beneficiam-se da baixa latência. Utilize 'felix' para promoções in-game ou 'atlas' para anúncios de notícias. Como o limite é de 4096 caracteres, divida diálogos longos em segmentos sincronizados com as animações da interface.
- Prefira formato OPUS para reduzir largura de banda em conexões móveis instáveis.
- Não use streaming; baixe o arquivo completo antes de exibir o diálogo.
Assistentes de voz
Em assistentes de comando, priorize velocidade. A voz 'nova' transmite energia clara para confirmações rápidas. Limite o texto a frases curtas para minimizar o tempo de geração, mantendo a interação fluida e responsiva.
- Defina 'response_format: mp3' para compatibilidade universal com players mobile.
- Monitore o limite de 60 requisições por minuto para evitar filas durante uso intenso.
Próximos passos
Para finalizar sua integração, utilize a base URL https://api.playqq1.com/v1 com a SDK OpenAI ou HTTP simples. A chave gerada em /get-api-key/ autentica todas as requisições, permitindo narração imediata em seus apps mobile.
Integração completa
Configure o base_url para apontar para o endpoint da AppVoz. Com isso, você mantém a compatidade com as SDKs existentes, facilitando a transição sem reescrever toda a lógica de requisição.
- Use
POST /v1/audio/speechpara gerar áudio. - Autentique com
Authorization: Bearer sua-chave.
Escalabilidade
O sistema processa solicitações sequencialmente, respeitando o limite de 60 requisições por minuto. Para textos longos, implemente o split automático em blocos de 4096 caracteres e junte os arquivos finais para manter a fluidez.
- Mantenha o saldo positivo para evitar interrupções.
- Monitore o uso no painel para planejar tops-up via USDT.
Suporte técnico
O suporte é exclusivo por e-mail. Não há atendimento telefônico ou chat ao vivo. Para dúvidas sobre integração ou cobrança, entre em contato diretamente através do formulário na página de contato.
Ouça as 8 vozes
Cada amostra abaixo foi gerada por esta API a partir da mesma frase. Acesse a página de criação de conta e escolha entre login com Google ou e-mail.
23 idiomas
Qualquer voz fala qualquer um desses idiomas.
