Communitygithub.com

hourlore

Recherchez un sujet historique, mystérieux ou commercial pour créer un storyboard documentaire gratuit de 8 à 12 plans, ou produisez un documentaire narré complet de 5 à 15 minutes en 1080p MP4 avec des photos d'archives Wikimedia Commons, des animations cartographiques et des sous-titres mot à mot avec Hourlore.

Qu'est-ce que hourlore ?

Hourlore est un outil de création documentaire longue durée (16:9, 1080p) qui transforme une simple ligne de sujet en un film narré. Il utilise des images d'archives Wikimedia Commons (domaine public, CC0, CC BY, CC BY-SA), des animations de vol cartographique, des cartes compteurs et des sous-titres mot à mot. L'outil s'adresse aux créateurs de contenu, historiens amateurs, journalistes ou toute personne souhaitant produire rapidement un documentaire de qualité sans compétences vidéo avancées. Hourlore propose une version gratuite (storyboard de 8 à 12 plans) et une version payante avec crédits pour la production complète (5 minutes = 25 crédits, 10 minutes = 50 crédits, 15 minutes = 75 crédits, avec 1 crédit par minute). Il supporte deux voix narratives : Olivia (féminine) et Owen (masculine). Le rendu complet prend environ 1 fois la durée du film (10–20 minutes). Une fois le film terminé, l'utilisateur reçoit une URL de téléchargement valable 1 heure, mais peut en obtenir une nouvelle dans les 30 jours. Hourlore est accessible via un agent utilisant l'API MCP (outils `create_storyboard_preview`, `create_documentary_film`, `get_documentary_film`, `cancel_documentary_film`, `get_credits`) ou directement via HTTP. La clé API est stockée dans la variable d'environnement `HOURLORE_API_KEY`. Il est essentiel de prévisualiser gratuitement avant de consommer des crédits et de confirmer le sujet, la durée et la voix auprès de l'utilisateur.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hourlore/hourlore-mcp/tree/HEAD/skills/hourlore

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Hourlore : créateur de documentaires narrés de 5 à 15 minutes

Hourlore (https://hourlore.com) transforme une simple ligne de sujet en un documentaire narré 16:9 (1080p) utilisant des images d'archives Wikimedia Commons (domaine public, CC0, CC BY, CC BY-SA), des animations de vol cartographique, des cartes compteurs et des sous-titres mot à mot.

Avant de commencer

  • Nécessite une clé API depuis https://hourlore.com/account stockée dans la variable d'environnement HOURLORE_API_KEY de l'utilisateur (hl_...). Ne demandez jamais à l'utilisateur de coder en dur des clés dans des fichiers source.
  • Prévisualisez d'abord, demandez avant de dépenser des crédits :
    • create_storyboard_preview est gratuit (jusqu'à 10 prévisualisations par jour par compte) et renvoie 8 à 12 plans d'ouverture en environ 25 secondes.
    • create_documentary_film coûte 25 crédits (5 min), 50 crédits (10 min) ou 75 crédits (15 min) (5 crédits = 1 minute). Confirmez toujours le sujet, la durée (5, 10 ou 15 minutes) et le narrateur (olivia féminin ou owen masculin) avec l'utilisateur avant de lancer un rendu complet.
  • Conservez le description_text renvoyé à côté de toute vidéo publiée afin de préserver les attributions Creative Commons (CC BY / CC BY-SA).

Avec les outils MCP (https://hourlore.com/mcp)

  1. Appelez create_storyboard_preview (topic, notes optionnel) pour tester l'angle et montrer à l'utilisateur la narration d'ouverture et les plans d'archives.
  2. Vérifiez le solde avec get_credits si nécessaire.
  3. Une fois approuvé, appelez create_documentary_film (topic, minutes : 5 | 10 | 15, voice : olivia | owen, notes optionnel, idempotency_key optionnel).
  4. Les rendus complets prennent environ 1× la durée du film (~10–20 minutes). Interrogez get_documentary_film (film_id, wait_seconds optionnel jusqu'à 50) jusqu'à ce que status === "completed", puis donnez à l'utilisateur download_url (valable 1 heure ; appelez get_documentary_film à nouveau à tout moment dans les 30 jours pour un lien frais) et description_text.
  5. Si l'utilisateur change d'avis juste après la mise en file, appelez cancel_documentary_film (film_id) tant que cancelable est true pour rembourser les crédits retenus.

Sans MCP (API HTTP)

URL de base : https://hourlore.com/api/v1 avec Authorization: Bearer $HOURLORE_API_KEY :

  • POST /api/v1/previews — { "topic": "...", "notes": "..." }
  • POST /api/v1/films — { "topic": "...", "minutes": 10, "voice": "owen", "notes": "..." } (en-tête Idempotency-Key optionnel)
  • GET /api/v1/films/:id — statut, download_url et description_text
  • DELETE /api/v1/films/:id — annuler la tâche en file et libérer les crédits retenus
  • GET /api/v1/credits — { credits, held, credits_per_minute: 5 }

Skills associés