Como criar um app de aprendizado de idiomas com vídeos do YouTube

O problema que resolve

O áudio dos livros didáticos é roteirizado e artificial, enquanto vídeos reais são difíceis demais para a maioria dos alunos sem apoio. Eles precisam ver o que está sendo dito, entender palavras desconhecidas na hora e praticar a escuta em pequenos trechos, com conteúdo que combine com seus interesses.

O que incluir na primeira versão

• ■Transcrições bilíngues lado a lado sincronizadas com a reprodução
• ■Tradução de palavras com um toque e vocabulário salvo
• ■Repetição de qualquer frase isolada
• ■Exercícios de lacunas e ditado com segmentos reais
• ■Níveis de dificuldade para ajudar o aluno a escolher vídeos

Como criar, passo a passo

1. 01

   Busque a transcrição original

   Chame /transcribe com o idioma do vídeo e format.words para obter o tempo de cada palavra.

2. 02

   Traduza como apoio

   Chame /transcripts/{video_id}/translate para o idioma nativo do aluno e monte a visualização bilíngue.

3. 03

   Sincronize com o player

   Use o tempo atual do player incorporado do YouTube para destacar o segmento e a palavra ativos.

4. 04

   Crie os exercícios

   Remova palavras dos segmentos para exercícios de lacunas, ou toque um segmento e peça ao aluno que digite o que ouviu.

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

Uma assinatura freemium para alunos funciona melhor, com planos pagos para vídeos ilimitados, vocabulário salvo e exercícios. Professores e escolas pagam por contas de turma e recursos de tarefas.

Erros a evitar

• ✕Usar só legendas automáticas como material didático: prefira legendas manuais quando houver, já que os alunos reproduzem o que veem.
• ✕Mostrar a tradução por padrão: deixe o aluno revelá-la para mantê-lo trabalhando no idioma alvo.
• ✕Ignorar a dificuldade: classifique os vídeos por velocidade de fala e vocabulário para não sobrecarregar iniciantes.

Dúvidas sobre esta ideia