Hourlore: 내레이션 포함 5~15분 다큐멘터리 제작 도구
Hourlore (https://hourlore.com)는 단일 주제를 조사하여 내레이션이 포함된 16:9 (1080p) 다큐멘터리로 변환합니다. Wikimedia Commons의 아카이브 이미지(퍼블릭 도메인, CC0, CC BY, CC BY-SA), 애니메이션 지도 비행, 숫자 카운터 카드, 단어별 자막을 사용합니다.
시작하기 전에
https://hourlore.com/account에서 API 키를 발급받아 사용자의HOURLORE_API_KEY환경 변수(hl_...)에 저장해야 합니다. 절대로 사용자에게 소스 파일에 키를 하드코딩하도록 요청하지 마세요.- 크레딧을 사용하기 전에 먼저 미리보기하고 사용자에게 확인을 받으세요:
create_storyboard_preview는 무료이며(계정당 일일 최대 10회 미리보기), 약 25초 만에 8~12개의 오프닝 샷을 반환합니다.create_documentary_film은 25 크레딧(5분), 50 크레딧(10분), 또는 75 크레딧(15분) 을 소비합니다(5 크레딧 = 1분). 전체 렌더링을 대기열에 추가하기 전에 항상 주제, 길이(5,10또는15분), 내레이터(olivia여성 또는owen남성)를 사용자와 확인하세요.
- 반환된
description_text는 게시된 비디오와 함께 보관하여 Creative Commons 저작자표시(CC BY/CC BY-SA)를 유지하세요.
MCP 도구 사용 (https://hourlore.com/mcp)
create_storyboard_preview(topic, 선택적notes)를 호출하여 앵글을 테스트하고 사용자에게 오프닝 내레이션과 아카이브 샷을 보여줍니다.- 필요한 경우
get_credits로 잔액을 확인합니다. - 승인되면
create_documentary_film(topic,minutes:5 | 10 | 15,voice:olivia | owen, 선택적notes, 선택적idempotency_key)을 호출합니다. - 전체 렌더링은 대략 영화 길이의 1배 정도 소요됩니다(
1020분).get_documentary_film(film_id, 선택적wait_seconds최대 50)을status === "completed"가 될 때까지 폴링한 후, 사용자에게download_url(1시간 유효, 30일 이내에get_documentary_film을 다시 호출하면 새 링크 발급)과description_text를 제공합니다. - 사용자가 대기열에 추가한 직후 마음이 바뀌면
cancel_documentary_film(film_id)을 호출합니다.cancelable이true인 동안 호출하면 보류된 크레딧이 환불됩니다.
MCP 없이 사용 (HTTP API)
기본 URL: https://hourlore.com/api/v1, Authorization: Bearer $HOURLORE_API_KEY 헤더 필요:
POST /api/v1/previews—{ "topic": "...", "notes": "..." }POST /api/v1/films—{ "topic": "...", "minutes": 10, "voice": "owen", "notes": "..." }(선택적Idempotency-Key헤더)GET /api/v1/films/:id— 상태,download_url및description_textDELETE /api/v1/films/:id— 대기 중인 작업 취소 및 보류 크레딧 해제GET /api/v1/credits—{ credits, held, credits_per_minute: 5 }