---
title: "Narração do passo (MP3 mono 64 kbps; usa a cota de áudio)"
method: POST
path: "/v1/tours/{id}/steps/{stepId}/narration"
---

# 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

- `id` string, required
- `stepId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `text` string: Texto a narrar (vira o roteiro do passo).
  - `language` string: 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.
  - `lang` string: 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.
  - `voice` string: 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 `201`

narration, usage

- object
  - `ok` true

## Other responses

- `400`: Erro
- `401`: Erro
- `402`: Erro
- `403`: Erro
- `404`: Erro
- `429`: Erro
- `502`: Erro
- `503`: Erro

---

[API](https://skmtc.dev/guiaflow/apis/guiaflow-api.md) · [All operations](https://skmtc.dev/guiaflow/apis/guiaflow-api/llms.txt) · [OpenAPI document](https://skmtc.dev/guiaflow/apis/guiaflow-api/revisions/1405464b8a2a?raw)