Hourlore: Creador de documentales narrados de 5 a 15 minutos
Hourlore (https://hourlore.com) convierte una sola línea temática en un documental 16:9 (1080p) investigado y narrado, utilizando imágenes de archivo de Wikimedia Commons (dominio público, CC0, CC BY, CC BY-SA), vuelos animados de mapas, tarjetas de contadores numéricos y subtítulos palabra por palabra.
Antes de empezar
- Se necesita una clave API de
https://hourlore.com/accountalmacenada en la variable de entornoHOURLORE_API_KEYdel usuario (hl_...). Nunca pidas al usuario que codifique claves en archivos fuente. - Previsualiza primero, pregunta antes de gastar créditos:
create_storyboard_previewes gratuito (hasta 10 previsualizaciones/día por cuenta) y devuelve 8 a 12 tomas de apertura en ~25 segundos.create_documentary_filmconsume 25 créditos (5 min), 50 créditos (10 min) o 75 créditos (15 min) (5 créditos = 1 minuto). Siempre confirma el tema, la duración (5,10o15minutos) y el narrador (oliviafemenino oowenmasculino) con el usuario antes de encolar un renderizado completo.
- Mantén el
description_textdevuelto junto a cualquier video publicado para que se conserven las atribuciones de Creative Commons (CC BY/CC BY-SA).
Con las herramientas MCP (https://hourlore.com/mcp)
- Llama a
create_storyboard_preview(topic, opcionalnotes) para probar el enfoque y mostrar al usuario la narración de apertura y las tomas de archivo. - Verifica el saldo con
get_creditssi es necesario. - Una vez aprobado, llama a
create_documentary_film(topic,minutes:5 | 10 | 15,voice:olivia | owen, opcionalnotes, opcionalidempotency_key). - Los renderizados completos tardan aproximadamente 1 × la duración de la película (~10–20 minutos). Consulta
get_documentary_film(film_id, opcionalwait_secondshasta 50) hasta questatus === "completed", luego proporciona al usuariodownload_url(válido 1 hora; puedes llamar aget_documentary_filmnuevamente en cualquier momento dentro de los 30 días para obtener un enlace fresco) ydescription_text. - Si el usuario cambia de opinión justo después de encolar, llama a
cancel_documentary_film(film_id) mientrascancelableseatruepara reembolsar los créditos retenidos.
Sin MCP (API HTTP)
URL base: https://hourlore.com/api/v1 con Authorization: Bearer $HOURLORE_API_KEY:
POST /api/v1/previews—{ "topic": "...", "notes": "..." }POST /api/v1/films—{ "topic": "...", "minutes": 10, "voice": "owen", "notes": "..." }(cabecera opcionalIdempotency-Key)GET /api/v1/films/:id— estado,download_urlydescription_textDELETE /api/v1/films/:id— cancelar trabajo en cola y liberar créditos retenidosGET /api/v1/credits—{ credits, held, credits_per_minute: 5 }