Hourlore:旁白 5–15 分钟纪录片制作器
Hourlore (https://hourlore.com) 将单一话题行转化为经过研究、配有旁白的 16:9(1080p)纪录片,使用维基共享资源档案图像(公有领域、CC0、CC BY、CC BY-SA)、地图飞行动画、数字计数器卡片和逐字字幕。
开始之前
- 需要从
https://hourlore.com/account获取 API 密钥,并存储在用户的HOURLORE_API_KEY环境变量中(hl_...)。切勿要求用户将密钥硬编码到源文件中。 - 先预览,询问后再消耗积分:
create_storyboard_preview免费(每个账户每天最多 10 次预览),约 25 秒内返回 8–12 个开场镜头。create_documentary_film消耗 25 积分(5 分钟)、50 积分(10 分钟) 或 75 积分(15 分钟)(5 积分 = 1 分钟)。在排队完整渲染前,务必与用户确认话题、时长(5、10或15分钟)和旁白(olivia女声或owen男声)。
- 保留返回的
description_text并随发布的视频一起保存,以确保 Creative Commons 署名(CC BY/CC BY-SA)得到保留。
使用 MCP 工具 (https://hourlore.com/mcp)
- 调用
create_storyboard_preview(topic,可选notes)测试角度,并向用户展示开场旁白和档案镜头。 - 如有需要,可通过
get_credits检查积分余额。 - 获得批准后,调用
create_documentary_film(topic,minutes:5 | 10 | 15,voice:olivia | owen,可选notes,可选idempotency_key)。 - 完整渲染大约需要 1 倍影片长度(约 10–20 分钟)。轮询
get_documentary_film(film_id,可选wait_seconds最多 50),直到status === "completed",然后向用户提供download_url(有效 1 小时;30 天内随时再次调用get_documentary_film可获取新链接)和description_text。 - 如果用户在排队后立即改变主意,可在
cancelable为true时调用cancel_documentary_film(film_id),以退还持有的积分。
不使用 MCP(HTTP API)
基础 URL:https://hourlore.com/api/v1,使用 Authorization: Bearer $HOURLORE_API_KEY:
POST /api/v1/previews—{ "topic": "...", "notes": "..." }POST /api/v1/films—{ "topic": "...", "minutes": 10, "voice": "owen", "notes": "..." }(可选的Idempotency-Key头)GET /api/v1/films/:id— 状态、download_url和description_textDELETE /api/v1/films/:id— 取消排队中的作业并释放已占用的积分GET /api/v1/credits—{ credits, held, credits_per_minute: 5 }