YouTube 영상으로 외국어 학습 앱 만드는 법

해결하는 문제

교재 음성은 대본을 읽은 것이라 부자연스럽고, 실제 영상은 도움 없이는 대부분의 학습자에게 너무 어렵습니다. 학습자는 자기 관심사에 맞는 콘텐츠로, 무슨 말이 나오는지 보고, 모르는 단어를 즉시 이해하고, 듣기를 작은 단위로 연습할 수 있어야 합니다.

첫 버전에 넣을 기능

• ■재생에 맞춰 동기화되는 이중 언어 나란히 보기 자막
• ■탭하면 번역되는 단어와 단어장 저장
• ■문장 하나만 다시 듣기
• ■실제 세그먼트로 만든 빈칸 채우기와 받아쓰기 연습
• ■학습자가 영상을 고르기 쉽게 돕는 난이도 평가

단계별 개발 방법

1. 01

   원어 자막 가져오기

   영상의 언어와 format.words를 지정해 /transcribe를 호출하면 단어 단위 타이밍을 얻을 수 있습니다.

2. 02

   보조용 번역

   학습자의 모국어로 /transcripts/{video_id}/translate를 호출해 이중 언어 보기를 만듭니다.

3. 03

   플레이어와 동기화

   YouTube 임베드 플레이어의 현재 시간을 사용해 재생 중인 세그먼트와 단어를 강조 표시합니다.

4. 04

   연습 문제 만들기

   세그먼트에서 단어를 비워 빈칸 채우기 문제를 만들거나, 세그먼트를 재생하고 학습자가 들은 내용을 입력하게 합니다.

스타터 코드

이 아이디어는 "레시피 1: 영상 하나를 넣고 구조화된 결과 받기" 패턴을 기반으로 합니다. 채널, 프롬프트, 저장소는 원하는 대로 바꿔 쓰세요.

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"])

만들 가치가 있는 이유

학습자 대상 프리미엄 구독이 가장 효과적이며, 무제한 영상, 단어장 저장, 연습 기능을 유료 등급으로 제공하세요. 교사와 학교는 학급 계정과 과제 기능에 비용을 지불합니다.

피해야 할 실수

• ✕학습 자료에 자동 자막만 사용하기: 학습자는 보이는 대로 따라 하므로, 가능하면 수동 자막을 우선하세요.
• ✕번역을 기본으로 보여 주기: 학습자가 직접 열어 보게 해야 목표 언어에 집중합니다.
• ✕난이도 무시하기: 초보자가 압도되지 않도록 말하는 속도와 어휘로 영상 난이도를 매기세요.

이 아이디어에 대한 질문