Hourlore: narrated 5–15 minute documentary maker
Hourlore (https://hourlore.com) turns a single topic line into a researched, narrated 16:9 (1080p) documentary using Wikimedia Commons archival images (public domain, CC0, CC BY, CC BY-SA), animated map flights, number counter cards and word-by-word captions.
Before you start
- Require an API key from
https://hourlore.com/accountstored in the user'sHOURLORE_API_KEYenvironment variable (hl_...). Never ask the user to hardcode keys into source files. - Preview first, ask before spending credits:
create_storyboard_previewis free (up to 10 previews/day per account) and returns 8–12 opening shots in ~25 seconds.create_documentary_filmholds 25 credits (5 min), 50 credits (10 min), or 75 credits (15 min) (5 credits = 1 minute). Always confirm the topic, duration (5,10or15minutes) and narrator (oliviafemale orowenmale) with the user before queuing a full render.
- Keep the returned
description_textalongside any published video so Creative Commons attributions (CC BY/CC BY-SA) are preserved.
With the MCP tools (https://hourlore.com/mcp)
- Call
create_storyboard_preview(topic, optionalnotes) to test the angle and show the user the opening narration and archive shots. - Check balance with
get_creditsif needed. - Once approved, call
create_documentary_film(topic,minutes:5 | 10 | 15,voice:olivia | owen, optionalnotes, optionalidempotency_key). - Full renders take roughly 1× the film length (~10–20 minutes). Poll
get_documentary_film(film_id, optionalwait_secondsup to 50) untilstatus === "completed", then give the userdownload_url(valid 1 hour; callget_documentary_filmagain anytime within 30 days for a fresh link) anddescription_text. - If the user changes their mind right after queuing, call
cancel_documentary_film(film_id) whilecancelableistrueto refund held credits.
Without MCP (HTTP API)
Base URL: https://hourlore.com/api/v1 with Authorization: Bearer $HOURLORE_API_KEY:
POST /api/v1/previews—{ "topic": "...", "notes": "..." }POST /api/v1/films—{ "topic": "...", "minutes": 10, "voice": "owen", "notes": "..." }(optionalIdempotency-Keyheader)GET /api/v1/films/:id— status,download_urlanddescription_textDELETE /api/v1/films/:id— cancel queued job and release held creditsGET /api/v1/credits—{ credits, held, credits_per_minute: 5 }