Pular para o conteúdo principal
Atualizado em Nov 16, 2026

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:

  1. Título desta etapa (aparece nos logs), no cabeçalho da etapa: opcional.
  2. 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ê querUse
O áudio em siTransformar 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á temPerguntar 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:

CampoO que faz
MarkdownO 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
FinalidadeRótulo opcional para o que esta etapa faz, exibido nos logs

O que as etapas seguintes podem usar​

ValorO que é
workflow.step(N).textA forma falada. Envie-a direto para o campo Texto de Transformar texto em fala
workflow.step(N).modelO modelo que produziu a reescrita

Limites​

LimiteValor
Tamanho da entrada8000 caracteres
Requisições de fala60 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ódigoO que aconteceu
spoken_text_too_longA 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.