Índice de capítulos

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 com os falantes identificados e os tempos das palavras, e depois o Plano de edição 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, 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 no modo Capítulos quando já tiver uma transcrição. Para também enxugar o episódio, use o Enxugar episódio.

Início rápido

Entradas

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

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

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.

• 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.

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

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ó, Edição no SDK e as ferramentas MCP de análise e EDL.