Hourlore: criador de documentários narrados de 5 a 15 minutos
Hourlore (https://hourlore.com) transforma uma única linha de tópico em um documentário narrado em 16:9 (1080p) usando imagens de arquivo da Wikimedia Commons (domínio público, CC0, CC BY, CC BY-SA), animações de voo sobre mapas, cartões numéricos e legendas palavra por palavra.
Antes de começar
- Necessita de uma chave de API de
https://hourlore.com/accountarmazenada na variável de ambienteHOURLORE_API_KEYdo usuário (hl_...). Nunca peça ao usuário para codificar chaves diretamente em arquivos fonte. - Primeiro o preview, depois pergunte antes de gastar créditos:
create_storyboard_previewé gratuito (até 10 previews/dia por conta) e retorna de 8 a 12 cenas iniciais em ~25 segundos.create_documentary_filmconsome 25 créditos (5 min), 50 créditos (10 min) ou 75 créditos (15 min) (5 créditos = 1 minuto). Sempre confirme o tópico, a duração (5,10ou15minutos) e o narrador (oliviafeminino ouowenmasculino) com o usuário antes de enfileirar uma renderização completa.
- Mantenha o
description_textretornado junto com qualquer vídeo publicado para que as atribuições Creative Commons (CC BY/CC BY-SA) sejam preservadas.
Com as ferramentas MCP (https://hourlore.com/mcp)
- Chame
create_storyboard_preview(topic, opcionalnotes) para testar o ângulo e mostrar ao usuário a narração inicial e as imagens de arquivo. - Verifique o saldo com
get_creditsse necessário. - Após a aprovação, chame
create_documentary_film(topic,minutes:5 | 10 | 15,voice:olivia | owen, opcionalnotes, opcionalidempotency_key). - As renderizações completas levam aproximadamente 1× o tempo do filme (~10–20 minutos). Consulte
get_documentary_film(film_id, opcionalwait_secondsaté 50) até questatus === "completed", então forneça ao usuáriodownload_url(válido por 1 hora; chameget_documentary_filmnovamente a qualquer momento dentro de 30 dias para obter um link renovado) edescription_text. - Se o usuário mudar de ideia logo após enfileirar, chame
cancel_documentary_film(film_id) enquantocancelablefortruepara reembolsar os créditos retidos.
Sem MCP (API HTTP)
URL base: https://hourlore.com/api/v1 com Authorization: Bearer $HOURLORE_API_KEY:
POST /api/v1/previews—{ "topic": "...", "notes": "..." }POST /api/v1/films—{ "topic": "...", "minutes": 10, "voice": "owen", "notes": "..." }(cabeçalho opcionalIdempotency-Key)GET /api/v1/films/:id— status,download_urledescription_textDELETE /api/v1/films/:id— cancela o trabalho enfileirado e libera os créditos retidosGET /api/v1/credits—{ credits, held, credits_per_minute: 5 }