GUIA DE DESENVOLVIMENTO · DESENVOLVEDORES DE APPS

Como criar um gerador de capítulos e show notes com IA para o YouTube

Capítulos, descrições e show notes ajudam os vídeos a ranquear e a manter o público assistindo, mas escrevê-los à mão leva um tempo que a maioria dos criadores não tem. Com os timestamps da transcrição, um LLM rascunha os três em segundos.

Para quem é
Ferramentas para criadores, apresentadores de podcast, editores de vídeo, agendadores de redes sociais
Tempo de desenvolvimento
Um fim de semana
Endpoints da API
/transcribe

O problema que resolve

Criadores e podcasters publicam toda semana e pulam os metadados porque é trabalhoso. Isso custa tráfego de busca, espaço nos vídeos sugeridos e retenção de público. Editores e agências que fazem isso manualmente gastam de 20 a 40 minutos por vídeo. Um gerador que produz rascunhos precisos e com timestamps elimina a maior parte desse trabalho.

O que incluir na primeira versão

  • Capítulos com timestamps no formato exigido pelo YouTube, começando em 0:00
  • Uma descrição com SEO, palavras-chave alvo e links
  • Show notes no estilo podcast com pontos principais e recursos mencionados
  • Configurações de tom de voz da marca por canal
  • Cópia ou publicação com um clique no YouTube, WordPress ou host de podcast

Como criar, passo a passo

  1. 01

    Busque a transcrição

    Chame /transcribe com format.timestamp e format.paragraphs para ter tanto o texto legível quanto os tempos de início.

  2. 02

    Detecte as mudanças de assunto

    Envie os parágrafos com seus timestamps a um LLM e peça que os agrupe em cinco a dez capítulos, usando apenas tempos de início que existem nos dados.

  3. 03

    Escreva a descrição e as notas

    Use um segundo prompt para escrever a descrição e as show notes a partir da lista de capítulos, incluindo as palavras-chave e os links do criador.

  4. 04

    Revise e publique

    Mostre os rascunhos em um editor, deixe o criador ajustá-los e então copie ou publique pela API da plataforma.

Código inicial

Esta ideia segue o padrão "Receita 1: entra um vídeo, sai um resultado estruturado". Use seus próprios canais, prompts e armazenamento.

import requests

API = "https://www.youtubetranscript.dev/api/v2"
HEADERS = {"Authorization": "Bearer yt_sk_live_YOUR_KEY"}

res = requests.post(f"{API}/transcribe", headers=HEADERS, json={
    "video": "https://www.youtube.com/watch?v=VIDEO_ID",
    "format": {"timestamp": True, "paragraphs": True},
}).json()

transcript = res["data"]["transcript"]
print(transcript["text"][:500])        # plain text for your LLM prompt
for seg in transcript["segments"][:3]:  # timestamps for deep links
    print(seg["start"], seg["text"])

Por que vale a pena criar

Cobre dos criadores uma assinatura mensal baseada em vídeos por mês, ou adicione como recurso pago dentro de uma ferramenta de edição, agendamento ou hospedagem de podcast. Agências pagam por assentos de equipe e predefinições de tom de voz da marca.

Erros a evitar

  • Deixar o modelo inventar timestamps: restrinja-o aos tempos de início dos segmentos da transcrição.
  • Gerar descrições genéricas: forneça as palavras-chave do canal e descrições anteriores como exemplo.
  • Esquecer as regras do YouTube: o primeiro capítulo precisa começar em 0:00 e são necessários pelo menos três capítulos.

Dúvidas sobre esta ideia

Qual a precisão dos capítulos do YouTube gerados por IA?

São precisos quando o modelo recebe timestamps reais da transcrição e é instruído a usar só esses. Mesmo assim, o criador deve revisar os títulos antes de publicar.

Capítulos automáticos ajudam no SEO do YouTube?

Os capítulos podem aparecer como momentos-chave nos resultados de busca do Google e facilitam a navegação em vídeos longos, o que ajuda na descoberta e na retenção.

Funciona para podcasts que não estão no YouTube?

Sim. Envie o arquivo de áudio pelo endpoint de uploads e a API o transcreve com reconhecimento de fala por IA.

Comece a criar hoje

10 créditos grátis todo mês. Sem cartão de crédito.

Como criar um gerador de capítulos para YouTube com IA | YouTubeTranscript.dev