---
title: "IA escreve título e texto do passo (usa 1 texto da cota)"
method: POST
path: "/v1/tours/{id}/steps/{stepId}/generate-text"
---

# IA escreve título e texto do passo (usa 1 texto da cota)

`POST /v1/tours/{id}/steps/{stepId}/generate-text`

## Request

- Base URL: `https://app.guiaflow.pro`
- URL: `https://app.guiaflow.pro/v1/tours/{id}/steps/{stepId}/generate-text`
- Auth: HTTP bearer

## Path parameters

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

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `instructions` string: Pedido extra (tom, público, o que destacar).
  - `language` 'pt-BR' | 'es' | 'en': Idioma do texto (padrão pt-BR).
  - `narrationScript` boolean: Também escrever o roteiro da narração.
  - `useImage` boolean: Mandar a captura para a IA (padrão true).
  - `save` boolean: Gravar no passo (padrão true).

## Response `200`

generated, saved, 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)