Hourlore: Vertonter 5-15-minütiger Dokumentarfilmersteller
Hourlore (https://hourlore.com) verwandelt eine einzelne Themenzeile mit Wikimedia Commons Archivbildern (Public Domain, CC0, CC BY, CC BY-SA), animierten Kartenflügen, Zahlenzähler-Karten und wortgenauen Untertiteln in einen recherchierten, vertonten 16:9 (1080p) Dokumentarfilm.
Bevor du beginnst
- Benötigt wird ein API-Schlüssel von
https://hourlore.com/account, der in derHOURLORE_API_KEY-Umgebungsvariable des Benutzers gespeichert ist (hl_...). Bitte den Benutzer niemals, Schlüssel direkt in Quelldateien zu schreiben. - Zuerst Vorschau anzeigen, dann vor dem Ausgeben von Credits nachfragen:
create_storyboard_previewist kostenlos (bis zu 10 Vorschauen/Tag pro Konto) und liefert in etwa 25 Sekunden 8–12 Eröffnungsszenen.create_documentary_filmkostet 25 Credits (5 Min.), 50 Credits (10 Min.) oder 75 Credits (15 Min.) (5 Credits = 1 Minute). Bestätige immer Thema, Dauer (5,10oder15Minuten) und Sprecher (oliviaweiblich oderowenmännlich) mit dem Benutzer, bevor du einen vollständigen Render in die Warteschlange stellst.
- Bewahre den zurückgegebenen
description_textzusammen mit jedem veröffentlichten Video auf, damit die Creative-Commons-Zuschreibungen (CC BY/CC BY-SA) erhalten bleiben.
Mit den MCP-Tools (https://hourlore.com/mcp)
- Rufe
create_storyboard_preview(topic, optionalnotes) auf, um den Blickwinkel zu testen und dem Benutzer die Eröffnungserzählung und die Archivaufnahmen zu zeigen. - Prüfe gegebenenfalls den Kontostand mit
get_credits. - Nach Freigabe rufe
create_documentary_filmauf (topic,minutes:5 | 10 | 15,voice:olivia | owen, optionalnotes, optionalidempotency_key). - Vollständige Renderings dauern etwa das 1-fache der Filmlänge (~10–20 Minuten). Frage
get_documentary_film(film_id, optionalwait_secondsbis zu 50) ab, bisstatus === "completed", und gib dem Benutzer danndownload_url(gültig 1 Stunde; rufeget_documentary_filmjederzeit innerhalb von 30 Tagen erneut auf, um einen neuen Link zu erhalten) unddescription_text. - Wenn der Benutzer seine Meinung direkt nach dem Einreihen ändert, rufe
cancel_documentary_film(film_id) auf, währendcancelabletrueist, um die reservierten Credits zurückzuerstatten.
Ohne MCP (HTTP-API)
Basis-URL: https://hourlore.com/api/v1 mit Authorization: Bearer $HOURLORE_API_KEY:
POST /api/v1/previews—{ "topic": "...", "notes": "..." }POST /api/v1/films—{ "topic": "...", "minutes": 10, "voice": "owen", "notes": "..." }(optionalerIdempotency-Key-Header)GET /api/v1/films/:id— Status,download_urlunddescription_textDELETE /api/v1/films/:id— abbrechen eines Auftrags in der Warteschlange und Freigabe reservierter CreditsGET /api/v1/credits—{ credits, held, credits_per_minute: 5 }