Perguntas frequentes
O que é TTS?
Text-to-Speech (TTS) converte texto em arquivo de áudio. Envie texto via JSON e receba o arquivo sintetizado. É uma API REST simples, sem necessidade de streaming ou SSML. Ideal para gerar narrações claras e consistentes em aplicativos de fitness e meditação, processando requisições de forma sequencial.
Como funciona a API?
Envie um POST para /v1/audio/speech com o texto, voz e idioma. A API retorna o arquivo de áudio. O limite é de 4096 caracteres por requisição. Use o SDK OpenAI alterando o base_url. Autentique com um token Bearer. Falhas são gratuitas e não cobram créditos.
Quais vozes usar para meditação?
Para meditação, utilize Luna (suave, narrativa) ou Sage (calma, instrucional). Para fitness, Felix (energético) ou Milo (conversacional) são adequados. Todas as 8 vozes suportam os 23 idiomas disponíveis. A escolha depende do tom desejado: mais suave para relaxamento ou mais dinâmico para exercícios.
Qual formato de áudio é melhor?
MP3 é o mais compatível e leve. WAV oferece qualidade sem perda. Opus é eficiente para streaming. FLAC preserva qualidade sem compressão. PCM é bruto. Escolha MP3 para balanceamento ou Opus para eficiência. Todos são suportados via parâmetro response_format na requisição JSON.
Como integrar com React Native?
Envie o POST para https://api.tk89.info/v1/audio/speech com o header Authorization. Receba o blob de áudio e reproduza usando bibliotecas padrão ou de terceiros. O formato JSON segue o padrão OpenAI, permitindo integração direta com SDKs existentes sem necessidade de bibliotecas proprietárias adicionais.
Como integrar com Flutter?
Use a biblioteca http para enviar a requisição POST. Configure o header Authorization Bearer. Defina o base_url para https://api.tk89.info/v1. Processe a resposta binária. O formato da requisição é idêntico ao padrão OpenAI, facilitando a adaptação de clientes existentes para nossa API.
Qual o custo para 1000 usuários?
O custo é $0.01 por 1.000 caracteres, independente do número de usuários. Não há custo fixo por conta ou licença. O preço é baseado no volume de caracteres processados. Se 1000 usuários gerarem 1 milhão de caracteres, o custo será $10. Sem taxas de infraestrutura.
Há limite de geração diária?
Não há limite diário fixo. O limite é de 60 requisições por minuto por chave. Antes do primeiro recarga, são 10 requisições por minuto. Não há limite de caracteres por dia, apenas pela taxa de requisições. O saldo não expira e não há plano mínimo.
Posso usar vozes em outros idiomas?
Sim, todas as 8 vozes falam os 23 idiomas suportados. Se o idioma não for especificado, o sistema tenta adivinhar, mas para textos em latim não-ingleses, defina o parâmetro language. Idiomas como Vietnamita ou Tailandês não são suportados. A precisão melhora com a especificação explícita.
O áudio tem marca d'água?
Sim, cada arquivo gerado contém uma marca d'água inaudível que indica ser fala sintética. Isso marca a origem do áudio como gerado pela API. A marca não afeta a qualidade de áudio ou a experiência do usuário final no aplicativo de fitness ou meditação.
Como gerenciar múltiplas vozes?
Escolha a voz no campo voice da requisição JSON. Use os nomes: aria, nova, luna, sage, felix, milo, atlas, orion. Você pode alternar entre vozes dinamicamente conforme o contexto da narração. Não há necessidade de configurar vozes separadamente; elas estão disponíveis via GET /v1/voices.
O que é base_url na integração?
É a URL base para todas as chamadas da API. Para este serviço, use https://api.tk89.info/v1. Ao usar o SDK OpenAI, altere este valor para que as requisições sejam roteadas corretamente para nossa infraestrutura. Isso permite usar o código padrão do SDK OpenAI sem modificações.
Introdução ao TTS para Fitness
Aplicativos de fitness e meditação exigem narração precisa para guiar sessões e manter o engajamento do usuário. A API TTS do Narrador Fit elimina a dependência de estúdios externos, permitindo gerar áudio sob demanda diretamente do código. Cada texto é convertido em arquivo de áudio com baixa latência, ideal para fluxos interativos.
Necessidade de áudio sob demanda
Em sessões de meditação ou treinos, o timing é crítico. Gerar áudio apenas quando necessário, sem pré-carregar arquivos pesados, otimiza o uso de banda e memória. A API processa solicitações em sequência, garantindo que cada instrução seja entregue no momento exato da prática.
- Integração direta via POST /v1/audio/speech
- Resposta em formatos como MP3, WAV ou OPUS
- Velocidade ajustável de 0.25x a 4.0x
Consistência de marca
As oito vozes pré-definidas, como Aria para narrativas ou Luna para meditação, garantem consistência técnica. Não há variações naturais de gravações humanas que possam quebrar a imersão. A mesma voz é utilizada em todos os idiomas suportados, mantendo a identidade do app uniforme em 23 línguas.
- 8 vozes fixas com características definidas
- Suporte nativo a 23 idiomas
- Marca sonora unificada globalmente
Redução de custos de produção
Substituir estúdios de gravação por uma API reduz custos operacionais significativamente. Com apenas US$ 0,01 por mil caracteres, o custo é previsível e escalável. Não há custos fixos de produção por sessão, apenas o uso real de caracteres gerados, ideal para startups que precisam de agilidade sem grandes investimentos iniciais.
- Pagamento por uso real
- Sem custos de estúdio ou locução
- Cálculo transparente por caractere
Escolhendo a Voz Certa
A escolha da voz impacta diretamente a retenção do usuário em apps de fitness e meditação. Cada preset foi calibrado para um contexto específico, garantindo clareza e consistência sonora sem necessidade de pós-produção extensa.
Use as vozes conforme a densidade de informação e o estado emocional desejado. A consistência tonal reduz a fadiga auditiva em sessões longas de áudio guiado.
Aria para narrativas
Aria possui um tom quente e claro, ideal para introduções de treinos ou explicação de técnicas. Sua articulação precisa garante que as instruções sejam compreendidas rapidamente, mesmo em ambientes externos com ruído.
Use Aria para vídeos de apresentação do app ou para narrativas que precedem os exercícios de força, onde a clareza da mensagem é prioritária.
- Tom: quente e narrativo
- Uso ideal: introduções e explicações
- Clareza: alta articulação
Luna para meditação
Luna oferece uma voz suave, perfeita para sessões de mindfulness e body scan. Sua cadência lenta e relaxante ajuda a induzir o estado de calma necessário para meditações guiadas.
Ideal para contar histórias ou guiar respirações, Luna mantém a atenção do usuário sem causar distrações, mantendo a coerência emocional da sessão.
- Tom: suave e storytelling
- Uso ideal: meditação e relaxamento
- Foco: imersão sonora
Atlas para instruções técnicas
Atlas é neutra e informativa, adequada para instruções técnicas de exercícios ou contagens de repetições. Sua voz transmite profissionalismo e precisão, sem emoções excessivas que possam distrair o usuário.
Utilize Atlas para listas de exercícios, instruções de postura ou qualquer conteúdo onde a informação técnica deva ser entregue com máxima objetividade.
- Tom: neutro e informativo
- Uso ideal: instruções claras
- Objetividade: alta
Formatos de Áudio
O formato de saída é definido pelo parâmetro response_format na requisição JSON. Escolha entre mp3, wav, opus, flac ou pcm conforme a necessidade de compatibilidade ou qualidade do seu app de fitness.
MP3 para compatibilidade
O MP3 é o padrão universal, garantindo reprodução imediata em qualquer navegador ou player de áudio móvel. Ideal para apps de meditação que priorizam a simplicidade de integração e a máxima compatibilidade com dispositivos antigos.
WAV para alta qualidade
O WAV oferece áudio sem compressão lossy, preservando a fidelidade original das vozes como Luna ou Sage. Utilize este formato para sessões de terapia ou áudio-books onde a nuances vocais são críticas.
OPUS para economia de banda (e FLAC/PCM também suportados)
O OPUS proporciona alta compressão com boa qualidade, reduzindo o consumo de dados dos usuários. FLAC e PCM estão disponíveis para casos que exigem arquivos brutos ou sem perda, conforme listado no endpoint /v1/voices.
- OPUS: ideal para economizar banda em conexões móveis.
- FLAC/PCM: para processamento posterior ou sem perda.
Integração Técnica
A autenticação utiliza um token Bearer enviado no cabeçalho Authorization. Cada conta possui uma única chave ativa válida para todas as requisições à API.
A gestão de tokens é simplificada: ao gerar uma nova chave, a anterior é invalidada imediatamente. Isso elimina a complexidade de gerenciamento de múltiplas credenciais em produção.
Autenticação Bearer
Envie o cabeçalho Authorization: Bearer tts-sua-chave em todas as requisições POST. O formato segue o padrão OpenAI, garantindo compatibilidade com SDKs oficiais sem adaptações complexas.
Gestão de tokens
A rotação de chaves é instantânea. Ao solicitar uma nova chave na interface, a antiga deixa de funcionar no mesmo instante, prevenindo uso indevido em caso de vazamento.
- Uma chave ativa por conta
- Invalidação imediata da chave antiga
Tratamento de erros
Requisições falhas são gratuitas e o crédito é estornado automaticamente. Retorna códigos de status HTTP padrão para facilitar a integração com sistemas de monitoramento e retry.
Otimização de Custos
O custo é estritamente proporcional à entrada: $10 por 1 milhão de caracteres, incluindo espaços e pontuação. Solicitações falhas são totalmente isentas, garantindo que você pague apenas pelo áudio gerado com sucesso.
Controle de caracteres
Cada requisição limita-se a 4096 caracteres. Para textos longos, divida manualmente ou via código em partes e una os arquivos resultantes. Isso evita erros de limite e mantém o controle preciso do consumo.
- Espaços e pontuação contam como caracteres.
- Limites rígidos de 4096 chars por request.
Uso de crédito gratuito
Registre-se com Google para receber $0,50 de crédito válido por 7 dias (aprox. 50.000 caracteres). Contas criadas com e-mail e senha iniciam sem bônus, ideal para testes imediatos sem compromisso.
Pagamento via USDT
Recarregue via USDT (TRC-20) na rede TRON. Mínimo de $5, com crédito automático em minutos. Sem cartões, PayPal ou faturas com VAT. O saldo não expira, permitindo escalonamento previsível.
Limites e Performance
O sistema processa requisições em fila única. Em picos de uso, a latência aumenta proporcionalmente à carga, mantendo a ordem de entrega sem perdas de áudio.
Gestão de filas
Requisições são processadas sequencialmente. Sob alta demanda, o tempo de geração pode exceder a velocidade real (25 caracteres/segundo) devido à espera na fila interna do serviço.
Limite de 60 req/min
Cada chave API aceita 60 solicitações por minuto. Contas novas iniciam com 10 req/min até o primeiro recarga. Exceder o limite retorna erro 429.
- Limite base: 60 req/min por chave
- Limite inicial (sem recarga): 10 req/min
Split de textos longos
O limite máximo é 4.096 caracteres por chamada. Para textos maiores, divida manualmente ou use um wrapper que segmente o input e junte os arquivos de áudio resultantes.
Exemplos de Código
A API aceita requisições POST para gerar áudio instantaneamente. O corpo da requisição deve conter o modelo, o texto de entrada, a voz selecionada e o formato desejado. A autenticação é feita via token Bearer no cabeçalho.
Exemplos abaixo demonstram as três formas mais comuns de integração: linha de comando para testes rápidos, SDK Python para aplicações robustas e fetch nativo para ambientes web.
Curl básico
Use curl para enviar texto e receber o arquivo de áudio diretamente. Substitua tts-sua-chave pela sua chave real.
``` curl -X POST "https://api.tk89.info/v1/audio/speech" \ -H "Authorization: Bearer tts-sua-chave" \ -H "Content-Type: application/json" \ -d '{"model": "tts-1", "input": "Respire fundo.", "voice": "luna", "response_format": "mp3"}' \ -o audio.mp3 ```
- Modelos: tts-1 ou tts-1-hd
- Vozes: aria, nova, luna, sage, felix, milo, atlas, orion
- Formatos: mp3, wav, opus, flac, pcm
Python com OpenAI SDK
O SDK oficial da OpenAI funciona alterando a URL base. Isso permite usar bibliotecas familiares para gerenciar a geração de áudio em seus projetos.
``` from openai import OpenAI client = OpenAI(api_key="tts-sua-chave", base_url="https://api.tk89.info/v1") response = client.audio.speech.create( model="tts-1", voice="luna", input="Mantenha a postura reta." ) response.stream_to_file("output.mp3") ```
- Base URL: https://api.tk89.info/v1
- Mantenha a estrutura padrão de parâmetros
- Tratamento de erros padrão do SDK
JavaScript fetch
Para aplicações front-end ou Node.js, utilize fetch nativo. O áudio retornado é um blob binário que pode ser convertido em URL ou salvo.
``` const response = await fetch("https://api.tk89.info/v1/audio/speech", { method: "POST", headers: { "Authorization": "Bearer tts-sua-chave", "Content-Type": "application/json" }, body: JSON.stringify({ model: "tts-1", voice: "atlas", input: "Sua série terminou." }) }); const audioBlob = await response.blob(); ```
- Use
response.blob()para capturar o áudio - Gerencie erros HTTP manualmente
- Compatible com fetch padrão

Casos de Uso: Meditação
A API TTS do Narrador Fit oferece vozes como Luna e Sage, ideais para meditação. O controle de velocidade (0.25–4.0) permite ajustar o ritmo da narração para sessões guiadas, garantindo consistência e clareza em 23 idiomas.
Essa flexibilidade técnica elimina a necessidade de gravações manuais repetitivas, permitindo que startups de wellness escalem seus produtos digitais com áudio de alta qualidade e baixo custo operacional.
Contagem de respiração
Utilize a voz Luna para narrar ciclos de respiração com pausas precisas. Com a API, é possível gerar arquivos de áudio onde cada instrução é sincronizada perfeitamente, criando uma experiência consistente.
Body scan guiado
A voz Sage oferece um tom calmante e instrucional, ideal para body scans. O texto é dividido em partes de até 4096 caracteres, mantendo a naturalidade da narração mesmo em sessões longas.
Músicas e sons ambiente
Gere narrações curtas que podem ser sobrepostas a sons ambiente. O formato MP3 ou OPUS otimiza o tamanho do arquivo, enquanto a velocidade ajustável permite alinhar a voz à trilha sonora da sua aplicação.
Casos de Uso: Fitness
Integrar narração em áudio às rotinas de treino elimina a necessidade de ler telas durante exercícios intensos. A API processa textos curtos com latência variável, permitindo que o áudio seja acionado dinamicamente conforme o progresso do usuário no app.
Esses casos de uso aproveitam vozes como Felix para energia ou Milo para conversação, mantendo a consistência da marca sem produção de estúdio.
Os exemplos abaixo demonstram como estruturar as chamadas de API para diferentes momentos da sessão de fitness.
Contagem de repetições
Utilize a API para gerar áudios dinâmicos que contam cada repetição em tempo real. Ao enviar o número atual via campo input, o sistema retorna um arquivo de áudio imediato.
A voz Felix transmite energia, ideal para momentos de esforço máximo. Como o limite é de 4096 caracteres, mensagens curtas como "Repetição 15" processam-se rapidamente.
Para sessões longas, o sistema gerencia a fila de requisições. Se houver alta demanda, o áudio pode levar alguns segundos, mas o custo permanece baixo por caractere.
- Envie o contador atual via JSON
input. - Use a voz
felixpara energia. - Mantenha o texto abaixo de 50 caracteres para velocidade máxima.
Temporizador de descanso
Configure o app para solicitar áudio ao iniciar um intervalo. A voz Milo oferece um tom conversacional e amigável, perfeito para avisos de descanso entre séries.
O campo speed permite ajustar a velocidade da narração para alertas rápidos ou instruções detalhadas sobre a próxima execução.
Como os formatos OPUS e MP3 são leves, o uso de banda é otimizado, crucial para usuários em conexões móveis durante treinos.
- Defina
speedentre 1.0 e 1.5 para clareza. - Prefira formato
opuspara economizar dados. - Voz recomendada:
milo.
Motivação pós-exercício
Após o término da sessão, a API pode gerar uma mensagem de encerramento personalizada. Use a voz Aria para um tom claro e encorajador.
O texto pode incluir estatísticas do treino, como tempo total ou calorias estimadas, convertidas para áudio instantaneamente.
O usuário recebe o arquivo diretamente na resposta da requisição, sem necessidade de armazenamento adicional no servidor.
- Use
ariapara tom inspirador. - Inclua métricas no campo
input. - Receba o áudio via
POST
Privacidade e Dados
A API TTS para Fitness e Meditação utiliza o texto de entrada exclusivamente para gerar o arquivo de áudio solicitado. Após a síntese, o conteúdo processado não é armazenado nem utilizado para treinar modelos de inteligência artificial, garantindo que suas vozes e roteiros permaneçam proprietários.
Texto não é treinado
Seus scripts de meditação ou instruções de treino não alimentam nosso banco de dados de treinamento. O uso é estritamente funcional para a geração do áudio no momento da requisição.
Retenção de metadados
Mantemos apenas os metadados necessários para a faturamento precisa: timestamp da requisição, volume de caracteres processados e status da transação. Esses dados servem exclusivamente para registrar o uso da API e garantir a cobrança correta do saldo.
Anonimização
Os metadados de uso são mantidos para fins contábeis, mas não vinculam diretamente sua identidade comercial ao conteúdo do áudio gerado. Não há retenção do arquivo de áudio final após o envio ao cliente.
Suporte e Manutenção
O suporte é exclusivamente por email. Não há telefone, chat ao vivo ou SLA contratado. As respostas são enviadas diretamente à sua caixa de entrada, sem escalonamento automático.
Para monitorar a saúde do serviço, consulte o status da API via endpoint GET /v1/models. Se houver degradação, as requisições podem entrar em fila. Não há página de status pública com tempo estimado de restauração.
Canal de email
Envie suas dúvidas ou relatos de bugs para o endereço de suporte listado na página de contato. Priorizamos questões técnicas relacionadas à integração e faturamento.
Não oferecemos suporte por telefone. Todas as comunicações são registradas para auditoria e garantia de consistência nas respostas.
- Resposta em até 24 horas úteis
- Sem chat ao vivo
- Sem números de telefone
Status da API
Verifique a disponibilidade dos endpoints principais acessando GET /v1/models. Uma resposta 200 indica que o serviço está operante.
Em caso de falhas na geração, o status HTTP indicará o erro. Não há página de status pública com tempo estimado de restauração.
- Endpoint
GET /v1/modelspara verificação - Sem página de status dedicada
Atualizações de endpoints
Alterações na API são anunciadas via email para contas ativas. Mantenha seu email cadastrado atualizado.
Novas versões do endpoint POST /v1/audio/speech mantêm compatibilidade com a estrutura OpenAI, garantindo estabilidade para sua aplicação.
- Notificações por email
- Compatibilidade OpenAI mantida
Próximos Passos
O ciclo de integração com a Narrador Fit começa pela obtenção de acesso e termina na entrega de áudio em produção. Este guia detalha os três passos técnicos essenciais para transformar texto em voz sintetizada de forma confiável.
Criação de conta
Acesse /get-api-key/ para registrar-se via Google ou e-mail. O sistema gera uma chave Bearer única e exibe o saldo inicial, se aplicável. Verifique a disponibilidade de crédito de teste ou realize o top-up via USDT (TRC-20) para garantir limites de 60 req/min.
- Acesso via /get-api-key/
- Geração automática de chave Bearer
- Top-up mínimo de $5 via USDT
Primeira requisição
- Endpoint: POST /v1/audio/speech
- Body: JSON com modelo, texto e voz
- Auth: Header Bearer token
Deploy em produção
Monitore a resposta do endpoint para obter o arquivo de áudio. Implemente lógica de retry para limites de taxa (429) e gerencie textos longos dividindo em chunks de 4096 caracteres. Armazene apenas metadados de faturamento; o áudio gerado não persiste no servidor.
- Tratamento de erros 429
- Split automático para textos >4096 chars
- Retenção apenas de metadados de billing
Ouça as 8 vozes
Cada amostra abaixo foi gerada por esta API a partir da mesma frase. Requisições falhas são gratuitas e o crédito é estornado automaticamente.
23 idiomas
Qualquer voz fala qualquer um desses idiomas.
