# Índice de capítulos

> O nó Índice de capítulos lista os capítulos de um podcast ou de uma entrevista em uma etapa, cada um com título e tempo de início, prontos para as notas.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/episode-chapters

O nó **Índice de capítulos** lista os capítulos da gravação de um podcast ou de uma entrevista em uma etapa. Ele transcreve a gravação e encontra os capítulos, cada um com título e tempo de início, prontos para colar nas notas do episódio ou na descrição de um vídeo. Nada é renderizado: o resultado é texto.

Por dentro, o nó executa as mesmas etapas que você pode conectar à mão: [**Transcrever**](https://nodaro.ai/docs/nodes/audio/transcribe) com os falantes identificados e os tempos das palavras, e depois o [**Plano de edição**](https://nodaro.ai/docs/nodes/video/edit-plan) no modo **Capítulos**. Cada etapa é executada como uma tarefa própria, então uma gravação longa, um cancelamento ou uma falha se comportam como em um workflow montado à mão.

O Índice de capítulos executa a etapa de planejamento no Nodaro Cloud. Em uma instalação auto-hospedada, [conecte a instalação ao Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect), em **Integrações › nodaro.ai** ou com uma chave de API. Sem uma conexão, o nó não é oferecido e uma execução é recusada antes de qualquer etapa começar.

## Quando usar
- Adicionar marcadores de capítulo às notas de um episódio de podcast.
- Adicionar tempos de início à descrição de um vídeo.
- Fazer um índice de uma entrevista ou de uma aula longa.
- Passar a lista de capítulos como JSON para um player, um site ou uma etapa seguinte do workflow.

Use você mesmo o [**Plano de edição**](https://nodaro.ai/docs/nodes/video/edit-plan) no modo **Capítulos** quando já tiver uma transcrição. Para também enxugar o episódio, use o [**Enxugar episódio**](https://nodaro.ai/docs/nodes/video/tighten-episode).

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Podcast › Índice de capítulos**. O nó também aparece na aba **Áudio**.

### Conectar a gravação
Conecte o episódio à entrada **Gravação**, por exemplo a partir de um nó [**Enviar áudio**](https://nodaro.ai/docs/nodes/audio/upload-audio) ou [**Enviar vídeo**](https://nodaro.ai/docs/nodes/video/upload-video). A gravação pode ter até 3 horas e precisa ter som.

### Orientar o plano
Se quiser, escreva **Instruções**, por exemplo `5 to 8 chapters, titles under six words` (de 5 a 8 capítulos, títulos com menos de seis palavras).

### Executar
Clique em **Executar** no nó. O nó mostra a lista de capítulos, com um botão que a copia.

Workflow: O Índice de capítulos transcreve um episódio gravado e retorna a lista de capítulos como notas do episódio e como JSON.

- Enviar áudio → Índice de capítulos (Gravação)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Gravação** | Vídeo ou áudio | A gravação do episódio, com até 3 horas. Ela precisa ter som. Obrigatória. |

Uma gravação com mais de 3 horas, ou uma gravação sem som, é recusada antes de qualquer cobrança. Com mais de uma gravação conectada, a execução lê a primeira.

## Saídas
| Saída | O que leva |
| --- | --- |
| **Notas do episódio** | A lista de capítulos como texto, uma linha por capítulo: o tempo de início e depois o título. Por exemplo `0:00 Intro` e `12:47 Why we moved`. |
| **Capítulos (JSON)** | Os mesmos capítulos em JSON, na mesma ordem: `[{ "startMs": 0, "title": "Intro" }]`. Cada `startMs` é o início em milissegundos. O primeiro capítulo começa em 0. |

Como as notas do episódio são escritas:

- **O primeiro capítulo começa em 0:00,** onde o player de quem ouve começa.
- **As horas só aparecem quando são necessárias.** Quando um capítulo começa em 1:00:00 ou depois, todas as linhas têm horas: `0:00:00 Intro`, `1:04:10 Questions`. Um episódio de 70 minutos cujo último capítulo começa em 58:00 mantém a forma curta.
- **Os tempos só aumentam.** Quando dois capítulos começam no mesmo segundo, o primeiro fica e os outros saem. Um capítulo que começa no primeiro segundo também sai.
- **Um título é uma linha.** Quebras de linha e sequências de espaços dentro de um título viram um espaço.

Em um app publicado, as notas do episódio aparecem como texto.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Qualidade do planejamento** | **Econômico** (o padrão), **Padrão** ou **Premium**. O nível da etapa Plano de edição, que define a qualidade e o preço do plano. |
| **Instruções** | Uma orientação curta para o plano, com até 4.000 caracteres. Por exemplo, `5 to 8 chapters` (de 5 a 8 capítulos) ou `short titles` (títulos curtos). |
| **Guia de estilo** | Orientações editoriais mais longas para o plano, com até 4.000 caracteres. |

## Se uma execução falhar
As etapas que terminaram continuam terminadas. A transcrição é mantida e não é cobrada de novo. Pressione **Continuar** no nó: só a etapa que falhou e as etapas depois dela são executadas de novo.

Um nó alimentado por uma Lista é executado uma vez por item. Ele não tem o botão **Continuar**, então execute-o de novo.

Quando o plano não encontra capítulos, a execução falha com a mensagem “The plan found no chapters in this recording.” (o plano não encontrou capítulos nesta gravação). A taxa por execução é reembolsada. A transcrição e o plano foram executados, então são cobrados pelos valores de cada um. Todas as etapas terminaram, então a execução não pode ser continuada e o nó não oferece **Continuar**. Execute o nó de novo, com outras instruções ou outra gravação.

## Créditos
O Índice de capítulos cobra cada etapa pelo valor dela, o mesmo do nó que ela representa, mais uma pequena taxa por execução. O nó mostra a estimativa completa, com a taxa, antes de você executar.

| Etapa | Preço |
| --- | --- |
| Transcrever, com ElevenLabs STT | 25 créditos por execução |
| Plano de edição, modo **Capítulos** | Por minuto iniciado da gravação, pelo valor da **Qualidade do planejamento**. Uma gravação de 30 minutos no **Econômico** custa 66 créditos. |

- **A taxa por execução** é cobrada uma vez por execução. A taxa de uma execução que falhou é reembolsada, e o **Continuar** a reserva de novo.
- **Uma Lista executa cada item como uma execução própria,** com a própria taxa.
- **A estimativa** conta os minutos da gravação do jeito que o Plano de edição conta. Uma gravação sem duração conhecida é estimada pelo teto de 180 minutos. Como o Plano de edição conta os minutos está explicado em [**Plano de edição**](https://nodaro.ai/docs/nodes/video/edit-plan#credits).

## Dicas
- **Diga quantos capítulos você quer.** Use **Instruções** para o número de capítulos e o estilo dos títulos, por exemplo `titles under six words` (títulos com menos de seis palavras).
- **Use a saída certa.** Conecte **Notas do episódio** a um campo de texto ou a uma etapa de publicação. Conecte **Capítulos (JSON)** onde você precisar dos tempos de início como números.
- **Comece no Econômico.** **Econômico** é o padrão. Experimente uma **Qualidade do planejamento** maior quando os capítulos precisarem ser mais precisos.

## Solução de problemas
| Problema | O que fazer |
| --- | --- |
| A execução é recusada antes de começar | Confira se a gravação tem no máximo 3 horas e tem som. |
| O plano não encontrou capítulos | Execute o nó de novo com outras **Instruções** ou com outra gravação. |
| Uma etapa falhou | Pressione **Continuar** no nó. As etapas que terminaram mantêm os resultados e não são cobradas de novo. |
| Faltam dois capítulos | Capítulos que começam no mesmo segundo que outro capítulo saem da lista. Peça menos capítulos, mais longos, em **Instruções**. |
| O nó não aparece em uma instalação auto-hospedada | Conecte a instalação ao Nodaro Cloud. Veja [Conectar ao Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect). |

## Pela API
O `POST /v1/episode-chapters` inicia uma execução e responde `202` com `jobId` e `executionId`. O corpo recebe `mediaUrls` (a URL de uma gravação) e, opcionalmente, `planTier`, `instructions` e `styleGuide`. Consulte a tarefa periodicamente com `GET /v1/jobs/:id/status`.

- O `output_data` da tarefa leva as notas do episódio (`text`), a lista de capítulos (`json`), o plano como o Plano de edição o fez (`plan`) e a transcrição (`transcript`). Uma execução que falhou mantém o que foi concluído e informa a etapa que falhou em `failedStep`.
- Um cabeçalho `Idempotency-Key` faz uma nova tentativa da mesma requisição responder com o mesmo `jobId` e `"deduped": true`, sem iniciar nada.
- O `POST /v1/episode-chapters/estimate` recebe o mesmo corpo e responde `{ data: { totalCredits, stepsCredits, feeCredits, durationSec } }`, sem iniciar nada.
- O `POST /v1/episode-chapters/continue` com `{ jobId, "mode": "from-failed" }` executa o que uma execução que falhou não concluiu. Uma execução em que todas as etapas terminaram responde `409 continuation_not_failed`. O Índice de capítulos não renderiza nada, então `"mode": "render-final"` responde `render_final_not_preview`.

O SDK (`client.edit.episodeChapters`, `client.edit.estimateEpisodeChapters`, `client.edit.continueUseCase`), a CLI (`nodaro edit episode-chapters`, com `--estimate` para uma cotação, e `nodaro edit continue-use-case`) e as ferramentas MCP `make_chapters`, `estimate_use_case` e `continue_use_case` chamam as mesmas rotas. Veja [Executar um único nó](https://nodaro.ai/docs/developers/api/nodes), [Edição no SDK](https://nodaro.ai/docs/developers/sdk/editing) e as [ferramentas MCP de análise e EDL](https://nodaro.ai/docs/mcp/tools/analysis-and-edl).

## Perguntas frequentes

### O que o nó Índice de capítulos faz?

O nó Índice de capítulos recebe uma gravação de podcast ou de entrevista e retorna os capítulos dela, cada um com título e tempo de início. Ele transcreve a gravação e depois planeja os capítulos. Nada é renderizado, então o resultado é texto.

### Em que formato vêm as notas do episódio?

O nó Índice de capítulos escreve uma linha por capítulo, com o tempo de início e o título, por exemplo 0:00 Intro. O primeiro capítulo sempre começa em 0:00. Quando um capítulo começa a partir de uma hora, todas as linhas passam a ter horas, como em 0:00:00 Intro.

### Quanto custa o nó Índice de capítulos?

O nó Índice de capítulos cobra as etapas pelos valores de cada uma, o Transcrever e o Plano de edição no modo Capítulos, mais uma pequena taxa por execução. O nó mostra a estimativa completa, com a taxa, antes de você executar.

### O que acontece quando o plano não encontra capítulos?

A execução do Índice de capítulos falha com a mensagem “The plan found no chapters in this recording.” (o plano não encontrou capítulos nesta gravação). A taxa por execução é reembolsada, mas a transcrição e o plano são cobrados. Execute o nó de novo com outras instruções ou outra gravação.

### Quando usar o Plano de edição no modo Capítulos em vez deste nó?

Use o Plano de edição no modo Capítulos quando você já tiver uma transcrição ou quiser o próprio objeto de capítulos do plano. O Índice de capítulos é a versão em uma etapa que parte da gravação.