Communitygithub.com

Hourlore

역사, 미스터리 또는 비즈니스 주제를 8~12장의 무료 다큐멘터리 스토리보드 미리보기로 조사하거나, Hourlore에서 Wikimedia Commons 아카이브 사진, 지도 애니메이션 및 단어별 자막이 포함된 5~15분 길이의 내레이션 1080p MP4 다큐멘터리를 렌더링합니다. 사용자가 장편 16:9 페이스리스 다큐멘터리를 기획하거나 제작하려 할 때 사용하세요.

Hourlore란 무엇인가요?

Hourlore는 단일 주제를 조사하여 내레이션이 포함된 16:9 (1080p) 다큐멘터리로 변환하는 AI 기반 도구입니다. 공개 도메인 및 Creative Commons 라이선스(Wikimedia Commons)의 아카이브 이미지를 사용하며, 애니메이션 지도 비행, 숫자 카운터 카드, 단어별 자막을 제공합니다. MCP 도구와 HTTP API를 모두 지원하여 Claude Code, Cursor, Codex 등 다양한 AI 어시스턴트와 통합될 수 있습니다. 사용자는 무료 스토리보드 미리보기(일일 최대 10회)로 콘셉트를 검증한 후, 크레딧을 소비하여 전체 다큐멘터리 영화(5/10/15분)를 렌더링할 수 있습니다. 렌더링이 완료되면 1시간 동안 유효한 다운로드 URL을 제공하며, 30일 이내에 다시 요청하면 새로운 링크를 받을 수 있습니다. 대기열에 올린 작업은 취소 가능한 경우 크레딧을 환불받을 수 있습니다. 내레이터는 여성(olivia)과 남성(owen) 중 선택 가능하며, API 키는 환경 변수로 저장해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hourlore/hourlore-mcp/tree/HEAD/skills/hourlore

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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)

  1. create_storyboard_preview (topic, 선택적 notes)를 호출하여 앵글을 테스트하고 사용자에게 오프닝 내레이션과 아카이브 샷을 보여줍니다.
  2. 필요한 경우 get_credits로 잔액을 확인합니다.
  3. 승인되면 create_documentary_film (topic, minutes: 5 | 10 | 15, voice: olivia | owen, 선택적 notes, 선택적 idempotency_key)을 호출합니다.
  4. 전체 렌더링은 대략 영화 길이의 1배 정도 소요됩니다(1020분). get_documentary_film (film_id, 선택적 wait_seconds 최대 50)을 status === "completed"가 될 때까지 폴링한 후, 사용자에게 download_url(1시간 유효, 30일 이내에 get_documentary_film을 다시 호출하면 새 링크 발급)과 description_text를 제공합니다.
  5. 사용자가 대기열에 추가한 직후 마음이 바뀌면 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_text
  • DELETE /api/v1/films/:id — 대기 중인 작업 취소 및 보류 크레딧 해제
  • GET /api/v1/credits — { credits, held, credits_per_minute: 5 }

관련 스킬