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/accountstockée dans la variable d'environnementHOURLORE_API_KEYde 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_previewest gratuit (jusqu'à 10 prévisualisations par jour par compte) et renvoie 8 à 12 plans d'ouverture en environ 25 secondes.create_documentary_filmcoû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,10ou15minutes) et le narrateur (oliviaféminin ouowenmasculin) avec l'utilisateur avant de lancer un rendu complet.
- Conservez le
description_textrenvoyé à 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)
- Appelez
create_storyboard_preview(topic,notesoptionnel) pour tester l'angle et montrer à l'utilisateur la narration d'ouverture et les plans d'archives. - Vérifiez le solde avec
get_creditssi nécessaire. - Une fois approuvé, appelez
create_documentary_film(topic,minutes:5 | 10 | 15,voice:olivia | owen,notesoptionnel,idempotency_keyoptionnel). - Les rendus complets prennent environ 1× la durée du film (~10–20 minutes). Interrogez
get_documentary_film(film_id,wait_secondsoptionnel jusqu'à 50) jusqu'à ce questatus === "completed", puis donnez à l'utilisateurdownload_url(valable 1 heure ; appelezget_documentary_filmà nouveau à tout moment dans les 30 jours pour un lien frais) etdescription_text. - Si l'utilisateur change d'avis juste après la mise en file, appelez
cancel_documentary_film(film_id) tant quecancelableesttruepour 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êteIdempotency-Keyoptionnel)GET /api/v1/films/:id— statut,download_urletdescription_textDELETE /api/v1/films/:id— annuler la tâche en file et libérer les crédits retenusGET /api/v1/credits—{ credits, held, credits_per_minute: 5 }