Gerar narração do passo
generate_narrationGera a narração falada do passo (voz do GuiaFlow, MP3 mono 64 kbps, 24 kHz) e grava como áudio do passo; o passo passa a durar pelo menos a narração. Texto: text, ou o roteiro (narrationScript) do passo, ou título + texto. Usa a cota mensal de áudio do Pro (30 min/mês).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Idioma-alvo do tour (ex.: en, es-MX) para gerar a narração traduzida desse idioma, com a voz configurada nele. Reaproveita o áudio (sem cobrar) se o texto e a voz não mudaram. | |
| text | No | Texto a narrar (vira o roteiro do passo). | |
| voice | No | id (UUID) de voz Cartesia (opcional; padrão: a voz do tour para o idioma, senão a voz nativa padrão do idioma). Precisa ser do mesmo idioma. | |
| stepId | Yes | ||
| tourId | Yes | id do tour (de create_tour ou list_tours). | |
| language | No | Idioma da narração de origem (opcional; padrão: o idioma de narração do tour, senão pt). Código Cartesia (pt, en, es, fr, de…). Voz nativa padrão: pt Isabella, en Lauren, es Ximena. |