모든 강의 영상에 접근성 높은 스크립트를 게시하는 법

해결하는 문제

학교와 강의 제작자는 스크립트가 없는 영상을 수백 개씩 보유하고 있거나, 문서로 읽을 수 없는 자동 자막만 가진 경우가 많습니다. 접근성 지원 부서는 편의 제공 요청을 하나씩 받습니다. 모든 영상에 읽기 쉬운 스크립트를 게시하면 밀린 요청이 사라지고 모든 학습자에게 이득이 됩니다.

첫 버전에 넣을 기능

• ■강의나 채널의 모든 영상에 대한 스크립트
• ■자막 없는 영상을 위한 AI 음성 인식
• ■가독성을 높이는 문단과 화자 라벨
• ■스크린 리더로 쉽게 탐색할 수 있는 HTML 스크립트 페이지
• ■다운로드 가능한 텍스트 및 자막 파일

단계별 개발 방법

1. 01

   영상 목록 파악

   각 강의 재생목록이나 채널을 조회해 스크립트가 필요한 모든 영상을 나열합니다.

2. 02

   일괄 변환

   format.paragraphs를 지정해 ID 목록을 /batch로 보냅니다. 웹훅과 함께 allow_asr를 활성화하면 자막 없는 영상도 AI 음성 인식으로 변환됩니다.

3. 03

   가독성 개선

   여러 명이 말하는 강의에는 ASR 화자 라벨을 사용하세요. 스크립트가 문서처럼 읽히도록 문단 구분과 소제목을 유지하세요.

4. 04

   게시

   각 스크립트를 영상 아래에 HTML 페이지나 접을 수 있는 섹션으로 렌더링하고 다운로드 링크를 제공합니다.

스타터 코드

이 아이디어는 "레시피 3: 재생목록을 지식 베이스에 일괄 적재하기" 패턴을 기반으로 합니다. 채널, 프롬프트, 저장소는 원하는 대로 바꿔 쓰세요.

import requests

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

playlist = requests.post(f"{API}/playlists/resolve", headers=HEADERS,
                         json={"playlist_url": "https://www.youtube.com/playlist?list=PLAYLIST_ID",
                               "limit": 100}).json()

ids = [v["video_id"] for v in playlist["items"]]
batch = requests.post(f"{API}/batch", headers=HEADERS, json={
    "video_ids": ids,
    "format": {"timestamp": True, "paragraphs": True},
}).json()

# Large batches run async: poll GET /batch/{batch_id} until status is "completed"
for r in batch.get("results", []):
    if r["status"] == "completed":
        for p in r["data"]["transcript"].get("paragraphs") or []:
            store(video_id=r["video_id"], start=p["start"], text=p["text"])  # your vector DB

만들 가치가 있는 이유

기관 입장에서는 접근성 의무를 더 빨리 충족하고 강의 콘텐츠를 더 쓰기 좋고 찾기 쉽게 만드는 것이 이점입니다. 에이전시와 플랫폼은 학교에 스크립트 게시를 서비스로 판매할 수 있습니다.

피해야 할 실수

• ✕자동 자막을 한 덩어리 텍스트로 게시하기: 문단과 화자로 정리하세요.
• ✕스크립트를 다운로드로만 제공하기: 읽기 쉽고 색인되도록 페이지에 텍스트를 직접 넣으세요.
• ✕AI 결과가 완벽하다고 가정하기: 특히 필수 편의 제공의 경우 전문 용어와 이름을 사람이 점검하게 하세요.

이 아이디어에 대한 질문