Communitygithub.com

Hourlore 纪录片制作器

将一个历史、谜案或商业话题研究为免费 8–12 镜头故事板预览,或使用 Hourlore 渲染成带有维基共享档案照片、地图动画和逐字字幕的完整 5–15 分钟 1080p 旁白纪录片。适用于用户希望策划或制作长格式 16:9 无人出镜纪录片时使用。

Hourlore 纪录片制作器 是什么?

Hourlore 是一个 AI 驱动的纪录片制作工具,它可以将单一话题快速转化为完整的旁白纪录片。它支持两种工作模式:免费的故事板预览,可生成 8–12 个开场镜头用于测试角度和叙事风格;以及付费的完整渲染模式,能够输出 5–15 分钟的 1080p MP4 视频。该工具集成了维基共享资源中的公有领域和 CC 许可档案图像、地图动画、数字计数器卡片以及逐字字幕,以创建专业的无人出镜纪录片。它通过 MCP 工具或直接 HTTP API 工作,需要 API 密钥以 `HOURLORE_API_KEY` 环境变量形式提供。在付费渲染之前,必须先获得用户对话题、时长和旁白声音的确认,然后轮询直到视频完成,再提供下载链接(1 小时内有效)和用于 CC 署名归因的描述文本。改进型脚本结构涵盖预设提示、审核、轮询和取消逻辑,简化了 AI 代理的工作流程。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hourlore/hourlore-mcp/tree/HEAD/skills/hourlore

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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)

  1. 调用 create_storyboard_preview(topic,可选 notes)测试角度,并向用户展示开场旁白和档案镜头。
  2. 如有需要,可通过 get_credits 检查积分余额。
  3. 获得批准后,调用 create_documentary_film(topic,minutes: 5 | 10 | 15,voice: olivia | owen,可选 notes,可选 idempotency_key)。
  4. 完整渲染大约需要 1 倍影片长度(约 10–20 分钟)。轮询 get_documentary_film(film_id,可选 wait_seconds 最多 50),直到 status === "completed",然后向用户提供 download_url(有效 1 小时;30 天内随时再次调用 get_documentary_film 可获取新链接)和 description_text。
  5. 如果用户在排队后立即改变主意,可在 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_text
  • DELETE /api/v1/films/:id — 取消排队中的作业并释放已占用的积分
  • GET /api/v1/credits — { credits, held, credits_per_minute: 5 }

相关技能