Preparar texto para fala
Use esta ação quando estiver prestes a falar um texto que foi escrito para ser lido e quiser que ele soe como algo que uma pessoa realmente diria. Ela devolve apenas texto — não produz áudio.
No editor
No seletor de ações, fica em IA e voz, como "Reescreve o texto como se fala". No fluxo, a etapa aparece assim: Reescrever Etapa 1 · choices · 0 · message · content para ser lido em voz alta.
Em O que ela faz:
- Título desta etapa (aparece nos logs), no cabeçalho da etapa: opcional.
- Texto a reescrever: o texto escrito, como Texto ou Expressão. Inserir dado traz valores do fluxo, normalmente a resposta de uma etapa anterior. No máximo 8.000 caracteres: um texto maior, ou um vazio, faz a etapa falhar.
Uma nota abaixo do texto diz o que a etapa faz: um modelo de IA reescreve um texto feito para ser lido (títulos, listas, tabelas, emojis) do jeito que uma pessoa falaria, e a etapa devolve texto, não áudio. Para ouvir, passe o texto desta etapa para Transformar texto em fala.
As etapas seguintes podem ler:
text: O texto reescrito, pronto para passar a "Transformar texto em fala".model: O modelo de IA que reescreveu o texto.- Passou: Sim quando esta etapa não falhou.
Toda etapa também tem Esta etapa roda, Se esta etapa falhar, a execução, Editar como campos, Ver como JSON e Concluir: veja O editor de etapas.
Nome anterior: Preparar texto falado.
Melhor para
- Preparar a resposta de um agente ou de um LLM antes de falá-la
- Falar um template ou um campo de texto formatado que contenha formatação
- Qualquer etapa cujo texto vá para Transformar texto em fala
Isso não é o mesmo que remover a formatação. Uma tabela não tem forma falada, então tirar a marcação não gera texto falável — gera uma sopa de palavras, lendo as células em sequência ou perdendo a resposta por completo. Esta ação pede a um modelo pequeno e barato que diga a mesma coisa do jeito que uma pessoa diria, enquanto o seu texto original fica intacto para o histórico.
Use outra coisa quando
| Você quer | Use |
|---|---|
| O áudio em si | Transformar texto em fala — rode esta ação antes e aquela depois |
| Conteúdo novo, e não a reescrita de um texto que você já tem | Perguntar a um modelo de IA — ela usa o seu próprio prompt e modelo |
Campos principais
Os campos da própria etapa, em Editar como campos e na API e no MCP:
| Campo | O que faz |
|---|---|
| Markdown | O texto escrito a reescrever para fala, com no máximo 8000 caracteres. Normalmente a resposta de uma etapa anterior, como workflow.step(0).choices[0].message.content |
| Finalidade | Rótulo opcional para o que esta etapa faz, exibido nos logs |
O que as etapas seguintes podem usar
| Valor | O que é |
|---|---|
workflow.step(N).text | A forma falada. Envie-a direto para o campo Texto de Transformar texto em fala |
workflow.step(N).model | O modelo que produziu a reescrita |
Limites
| Limite | Valor |
|---|---|
| Tamanho da entrada | 8000 caracteres |
| Requisições de fala | 60 por minuto, por empresa |
A reescrita tem um orçamento de saída de 1200 tokens, que não garante o limite de 4096 caracteres da síntese. Confira size(workflow.step(N).text) antes de sintetizar; divida textos maiores em trechos de no máximo 4096 caracteres.
O teto de 60 por minuto é compartilhado com o modo de voz do aplicativo e com Transformar texto em fala, então um par preparar-e-falar custa duas dessas requisições por execução.
Custo
Esta etapa é descontada do uso de tokens de IA do seu plano, e não do uso de áudio. Ela roda em um modelo pequeno e barato escolhido para você — você não pode escolher o modelo, porque a tarefa é uma reescrita mecânica e não raciocínio, e não deveria custar preço de raciocínio.
Quando falha
| Código | O que aconteceu |
|---|---|
spoken_text_too_long | A entrada passa de 8000 caracteres. Encurte-a ou divida-a em várias etapas |
O modo de voz do aplicativo cai discretamente para o texto puro quando essa reescrita falha, mas um workflow não tem essa saída: uma falha aqui faz a etapa falhar. Se quiser a mesma degradação suave, condicione a etapa de síntese a workflow.stepOk(N) e envie o texto original pelo outro caminho.