Perguntas frequentes
O que é um audioguia de museu?
É uma narração em áudio que acompanha a visita, oferecendo contexto histórico e descritivo sobre as exposições. Utilizamos uma API de texto-para-fala para transformar roteiros escritos em arquivos de áudio prontos, permitindo que visitantes acessem informações detalhadas de forma autônoma e personalizada durante a visita.
Posso usar a API para idiomas específicos?
Sim, oferecemos suporte para 23 idiomas, incluindo português, inglês, espanhol, francês, alemão, italiano, japonês, chinês, árabe e russo. Você pode definir o idioma explicitamente ou deixar que a API detecte automaticamente pelo script do texto. Verifique a lista completa de idiomas suportados na documentação.
Qual voz é melhor para narrativas históricas?
Para narrativas históricas, recomendamos Atlas (neutral, news) ou Orion (deep, documentary). Atlas oferece um tom neutro e informativo, ideal para contextualização factual. Orion traz uma voz mais profunda, perfeita para documentários e histórias com tom mais solene. Ambas garantem clareza e profissionalismo para o seu conteúdo.
Como garantir a qualidade do áudio?
Utilize o modelo tts-1-hd para áudio de alta definição. O texto deve ter até 4096 caracteres por solicitação. Para roteiros longos, divida o texto em partes menores e junte os arquivos de áudio gerados. A velocidade padrão é ajustada para uma narração clara e compreensível, próxima do tempo real.
Preciso de hardware especial para tocar os áudios?
Não. Os arquivos gerados (mp3, wav, opus, flac, pcm) são compatíveis com qualquer dispositivo moderno, como smartphones, tablets, computadores e sistemas de som de museus. Não há necessidade de hardware específico ou players proprietários; basta reproduzir os arquivos de áudio padrão diretamente nos seus dispositivos.
Quanto tempo leva para gerar um audioguia completo?
A geração é aproximadamente em tempo real, processando cerca de 25 caracteres por segundo. Para roteiros longos, o tempo total depende do tamanho do texto e da fila de processamento. Solicitações são processadas em sequência, podendo haver espera em momentos de alta demanda. Teste com trechos curtos para estimar.
Posso atualizar o áudio se o roteiro mudar?
Sim. Basta enviar o novo texto para a API e gerar um novo arquivo de áudio. Não há limite de gerações com base no saldo. Você pode substituir o arquivo antigo pelo novo em seus sistemas de áudio ou aplicativos, mantendo o conteúdo sempre atualizado com as informações mais recentes.
A API suporta acentos corretos em outros idiomas?
Sim, a API reconhece acentos e caracteres especiais dos idiomas suportados. Para textos em latim não ingleses, recomendamos definir o parâmetro 'language' explicitamente para garantir a pronúncia correta. A detecção automática funciona bem, mas a definição manual evita erros de pronúncia em idiomas com regras fonéticas complexas.
Há limite de tamanho para o arquivo final?
O limite é de 4096 caracteres por solicitação de API. Para audioguias longos, você deve dividir o roteiro em partes menores, gerar cada parte individualmente e depois juntar os arquivos de áudio. Não há limite de tamanho para o arquivo final combinado, apenas para cada requisição única.
Posso usar o áudio em apresentações ao vivo?
Sim, os arquivos de áudio gerados podem ser reproduzidos em apresentações ao vivo, eventos ou tours guiados. Os formatos suportados (mp3, wav, etc.) são amplamente compatíveis com sistemas de som padrão. Lembre-se que o áudio é gerado sob demanda, então planeje o tempo de geração para evitar atrasos.
O áudio tem marca d'água invisível?
Sim, cada arquivo de áudio gerado contém uma marca d'água inaudível que identifica o conteúdo como fala sintética. Isso é feito automaticamente pela API em todos os arquivos gerados, independentemente do modelo ou voz escolhida, garantindo a transparência sobre a origem do áudio para seus visitantes.
Como medir o tempo de geração?
O tempo de geração é aproximadamente de 25 caracteres por segundo para textos longos. Para frases curtas, pode levar alguns segundos. Em momentos de alta demanda, as solicitações podem aguardar na fila. Monitore o status da sua conta para entender o tempo médio de processamento atual.
Posso criar áudios em lotes?
Sim, você pode enviar múltiplas solicitações para gerar vários arquivos de áudio simultaneamente ou em sequência. A API processa as requisições uma após a outra. Para roteiros extensos, divida o texto em partes de até 4096 caracteres e combine os arquivos resultantes para criar o audioguia completo.
Há suporte para legendas sincronizadas?
Não, a API foca exclusivamente na geração de áudio a partir de texto. Não oferecemos sincronização automática de legendas. Você precisará criar as legendas manualmente ou utilizar ferramentas externas para sincronizar o texto com o áudio gerado, baseando-se no tempo de geração conhecido.
Entendendo a necessidade de audioguias
Audioguias transformam a visita passiva em uma experiência imersiva. Com narração de qualidade, os visitantes absorvem informações históricas com maior retenção, sentindo-se guiados por um anfitrião presente em cada sala do museu.
Melhoria na experiência do visitante
A áudio-narração guia o olhar e contextualiza as obras, elevando o valor percebido da visita. O som de alta qualidade mantém o engajamento sem exigir leitura constante de placas.
Acesso a múltiplos idiomas
Com suporte a 23 idiomas, você pode atender turistas internacionais sem precisar contratar novos locutores. Qualquer voz pode falar qualquer língua da lista, garantindo consistência sonora em todos os idiomas.
Atualização fácil de conteúdo
Exposições temporárias mudam frequentemente. Com a API, você gera novos roteiros em minutos e os substitui nos reprodutores, mantendo o conteúdo sempre atualizado sem custos de estúdio.
Escolhendo a voz adequada
Escolher a voz certa define a experiência do visitante. A API oferece oito presets licenciados, cada um com personalidade distinta, para que você alinhe o tom do audioguia ao ambiente do museu ou à intenção educativa da sala.
Vozes narrativas como Aria
Aria possui uma voz quente e clara, ideal para narrativas contínuas e histórias que guiam o visitante por exposições. Sua entonação natural torna a escuta fluida, mantendo o interesse sem cansar o ouvido.
Tom informativo como Atlas
Atlas entrega uma voz neutra e direta, perfeita para descrições técnicas, datas ou informações factuais em painéis. Sua clareza garante que detalhes importantes sejam compreendidos sem distrações emocionais, ideal para contextos mais formais.
Personalidade com Milo
Milo traz uma abordagem amigável e conversacional, excelente para audioguias interativos ou tours mais descontraídos. Sua voz próxima ao usuário cria uma sensação de companhia, tornando a visita mais acolhedora e envolvente.
Preparando os roteiros
O texto deve ser dividido em trechos de no máximo 4096 caracteres por solicitação. Isso garante que cada seção da sua exposição seja processada de forma independente e eficiente.
Limite de caracteres por trecho
Cada requisição suporta até 4.096 caracteres, incluindo espaços e pontuação. Exceder esse limite gera erro, então divida seus roteiros antes de enviar.
Quebras lógicas de texto
Divida o roteiro em pontos de interesse ou parágrafos curtos. Isso facilita a gestão e permite regenerar apenas trechos específicos sem refazer todo o áudio.
Instruções de velocidade
Ajuste a velocidade entre 0,25 e 4,0 para controlar o ritmo da narração. Para audioguias, velocidades entre 0,9 e 1,1 oferecem a melhor clareza para visitantes.
Gerando o áudio via API
Para transformar seu roteiro em áudio, você envia um JSON via POST para o endpoint https://api.talkbet.info/v1/audio/speech. A API aceita textos de até 4096 caracteres por requisição, retornando o arquivo de áudio diretamente na resposta.
Requisição POST para o endpoint
Utilize o SDK OpenAI ou HTTP direto, ajustando o base_url para https://api.talkbet.info/v1. Autentique-se com o cabeçalho Authorization: Bearer contendo sua chave única.
Configuração de parâmetros
Defina o model (tts-1 ou tts-1-hd), o voice (ex: aria, atlas), o input com seu texto e o response_format desejado (mp3, wav, opus, flac, pcm). A velocidade pode ser ajustada entre 0.25 e 4.0.
Recepção do arquivo de áudio
A API retorna o arquivo binário pronto para uso. Se a síntese falhar, não há cobrança. Para textos longos, divida em partes menores e junte os arquivos finais.
Formatos ideais para museus
Escolher o formato de áudio correto é essencial para garantir que sua coleção de audioguias rode suavemente em diferentes reprodutores de museu ou aplicativos móveis. A API da NarraTuri permite gerar arquivos em múltiplos formatos, equilibrando qualidade de som, tamanho do arquivo e compatibilidade técnica.
MP3 para compatibilidade geral
O MP3 é o formato mais universal. Quase todos os reprodutores dedicados, smartphones e tablets conseguem tocar MP3 sem necessidade de codecs extras. É a escolha segura para garantir que qualquer visitante consiga ouvir o guia, independentemente do dispositivo usado.
WAV para alta fidelidade
Se a prioridade é a máxima qualidade de som sem perda de dados, o formato WAV é ideal. Ele não utiliza compressão, resultando em arquivos maiores, mas preserva todos os detalhes da voz. É excelente para coleções de áudio de alta fidelidade ou para arquivos mestre que serão editados posteriormente.
OPUS para economia de espaço
O OPUS oferece boa compressão, uma das opções de formato disponíveis. Ele é ideal para reduzir o tamanho dos arquivos sem sacrificar drasticamente a inteligibilidade da fala. Isso facilita o armazenamento em massa de roteiros longos ou a transmissão rápida em aplicativos móveis com dados limitados.
Integração com dispositivos
Integrar a NarraTuri aos dispositivos de um museu é simples: você baixa os arquivos de áudio gerados pela API e os carrega diretamente nos reprodutores dedicados ou nos aplicativos dos visitantes. Não há necessidade de infraestrutura complexa, já que os arquivos são estáticos e prontos para reprodução offline.
Essa abordagem garante que o áudio toque com clareza, mesmo em áreas com conexão de internet instável. Você mantém o controle total do conteúdo, escolhendo o formato ideal para cada dispositivo sem depender de serviços de streaming em tempo real.
Reprodutores dedicados
Os reprodutores de áudio de museu, aqueles pequenos dispositivos instalados junto às obras, são perfeitos para armazenar os arquivos MP3 ou WAV gerados. Basta copiar os arquivos para a memória interna do aparelho. A qualidade do som depende apenas do hardware do reprodutor, não da API.
- Armazenamento local dos arquivos de áudio
- Reprodução independente de conexão com internet
- Formatos compatíveis: MP3, WAV, OPUS
Aplicativos móveis
Para visitas guiadas via smartphone, os arquivos de áudio podem ser baixados e armazenados no app do museu. O visitante inicia a reprodução ao aproxi-mar-se da obra. Como os arquivos são pré-gerados, não há latência de carregamento, garantindo uma experiência fluida e sem interrupções durante o passeio.
- Download prévio para uso offline
- Reprodução instantânea ao acessar o local
- Sem dependência de streaming ao vivo
Dispositivos IoT
Displays interativos ou telas com alto-falantes embutidos podem executar os arquivos de áudio diretamente. Você integra os arquivos gerados pela NarraTuri no sistema de mídia do dispositivo. Isso permite que o conteúdo áudio seja acionado por sensores ou toques na tela, sem necessidade de código complexo para streaming.
- Integração simples com sistemas de mídia
- Acionamento por sensores ou toques
- Sem necessidade de SDK específico

Testando a qualidade
Validar a intelligibilidade é crucial para garantir que visitantes, especialmente em ambientes com eco, compreendam cada detalhe da exposição sem esforço auditivo.
Testar em diferentes horários ajuda a identificar como o ruído de fundo interfere na experiência, permitindo ajustes antes da instalação definitiva.
Verificação de clareza
Ouça os arquivos em dispositivos móveis e alto-falantes dedicados para verificar se as pausas naturais da voz (como Luna ou Atlas) mantêm a dicção nítida.
Verifique se a velocidade padrão (1.0) ou ajustes para 0.75 não comprometem a compreensão de termos técnicos ou nomes próprios.
- Teste em alto-falantes tipo "bluetooth" comuns em visitas guiadas
- Verifique a transição entre trejos gerados separadamente
Teste de ruído ambiente
Coloque o áudio para tocar em ambientes simulando a presença de público ou ar-condicionado, já que museus raramente são silenciosos.
Use formatos como MP3 para garantir compatibilidade, mas valide se a qualidade não fica turva em alto volume.
Feedback de usuários
Peça para visitantes reais testarem os roteiros e coletar impressões sobre o tom e o ritmo da narração.
Use esses dados para ajustar a voz escolhida ou a velocidade antes de liberar o audioguia oficialmente.
Mantendo o conteúdo atualizado
A atualização constante é essencial para manter o audioguia relevante. Com a API, você não precisa refazer gravações inteiras; basta regenerar os trechos específicos que sofreram alterações, economizando tempo e mantendo a qualidade do conteúdo.
Regeneração rápida de trechos
Para modificar um trecho, envie novamente o texto atualizado para o endpoint de fala. O sistema processa a nova síntese e retorna o arquivo de áudio substituto. Isso permite correções de pronúncia ou ajustes de roteiro sem interromper a experiência dos visitantes em outros setores.
Atualização de roteiros
Roteiros podem ser editados a qualquer momento. Como cada solicitação gera um arquivo independente, você pode reenviar apenas as partes que mudaram. Isso é ideal para notícias temporárias ou informações sazonais, garantindo que o visitante sempre receba dados precisos.
Consistência de vozes
Mantenha a mesma voz (como Luna ou Atlas) em todo o roteiro para garantir uma identidade sonora unificada. Ao atualizar textos, selecione o mesmo parâmetro de voz. Isso evita que o visitante perceba mudanças abruptas de estilo ou tom entre as seções do museu.
Custo-benefício para museus
Eliminar estúdios de gravação reduz drasticamente o investimento inicial e os custos recorrentes com locutores para cada nova exposição ou trilha.
O modelo de pagamento por uso elimina mensalidades fixas.
Sem custos de gravação em estúdio
Não há necessidade de reservar salas acústicas nem contratar talentos para gravações pontuais. Você gera o áudio sob demanda, pagando apenas pelo que utiliza.
Escala para múltiplos idiomas
Com 23 idiomas disponíveis, é possível oferecer audioguias completos em diversos idiomas sem precisar de novos profissionais de voz. Cada idioma é gerado automaticamente a partir do mesmo roteiro base.
Pagamento pelo uso
A tarifa é de US$ 10 por 1 milhão de caracteres. Não há mensalidades, planos de assinatura ou custos de manutenção. O saldo não expira e falhas na síntese são gratuitas.
- US$ 0,01 por 1.000 caracteres (incluindo espaços)
Exemplo prático de uso
Veja como transformar um roteiro curto em áudio pronto para audioguias. Este exemplo foca na Sala das Cerâmicas, com texto simples e direto.
A escolha da voz Luna garante uma narração suave e envolvente, ideal para contar histórias de peças antigas sem soar robótico.
Roteiro de uma sala específica
O texto original descreve a origem e a técnica de produção das cerâmicas. Com menos de 4096 caracteres, ele cabe em uma única requisição, simplificando o processo.
Não há necessidade de divisões complexas. O sistema processa o texto inteiro de uma vez, economizando tempo de desenvolvimento.
- Texto original focado na história das peças
- Duração estimada de cerca de 30 segundos
Configuração de voz Luna
Definimos o parâmetro voice como luna. Esta voz feminina transmite uma narrativa suave, perfeita para audioguias museológicos.
A velocidade padrão é mantida, garantindo clareza e respeito ao ritmo natural da fala para os visitantes.
Geração e download do arquivo
Enviamos o texto via POST para o endpoint da API. O sistema retorna o arquivo de áudio em formato MP3.
O arquivo está pronto para ser integrado ao reprodutor do museu ou baixado para validação imediata.
Considerações técnicas finais
Para garantir o funcionamento contínuo do seu audioguias, o gerenciamento da chave de API é direto. Você pode emitir uma nova chave a qualquer momento pela página /get-api-key/, fazendo com que a anterior seja invalidada instantaneamente, o que é ideal para segurança caso haja suspeita de uso indevido.
Gerenciamento de chaves
Cada conta possui apenas uma chave ativa por vez. A emissão de uma nova chave é imediata e a antiga deixa de funcionar no mesmo instante, facilitando a revogação sem necessidade de espera ou confirmação manual.
- Emissão ilimitada de novas chaves
- Invalidação instantânea da chave antiga
- Uma chave ativa por conta
Monitoramento de uso
O painel mostra o saldo atual, os créditos de teste restantes e o consumo de caracteres. Como os metadados das requisições (tempo, status e caracteres) são mantidos apenas para faturamento, você tem transparência total sobre o gasto sem dados excessivos.
- Visualização de saldo em tempo real
- Controle de caracteres consumidos
- Histórico de status das requisições
Suporte por e-mail
Não oferecemos chat ao vivo ou telefone. Todo o atendimento é feito por e-mail, permitindo que você envie logs da API ou detalhes do roteiro para resolução mais precisa. Para dúvidas técnicas, a documentação detalhada está disponível em /docs/.
Ouça as 8 vozes
Cada amostra abaixo foi gerada por esta API a partir da mesma frase. Sua conta é criada instantaneamente, pronta para gerar os primeiros áudios de narração turística.
23 idiomas
Qualquer voz fala qualquer um desses idiomas.
