Narração do passo (MP3 mono 64 kbps; usa a cota de áudio)

post/v1/tours/{id}/steps/{stepId}/narration

Request

  • Base URL: https://app.guiaflow.pro
  • URL: https://app.guiaflow.pro/v1/tours/{id}/steps/{stepId}/narration
  • Auth: HTTP bearer

Path parameters

idstring required
stepIdstring required

Headers

Idempotency-Keystring

Repetir o POST com a mesma chave (24 h) devolve a mesma resposta.

Request body

textstring

Texto a narrar (vira o roteiro do passo).

languagestring

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.

langstring

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.

voicestring

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.

Response

narration, usage

oktrue

Changes

No recorded changes to this operation across all 1 revision of this API.