Hourlore:5–15 分鐘旁白紀錄片製作工具 是做什麼的?
Hourlore(https://hourlore.com)能將一個主題轉化為經過研究、帶有旁白的 16:9(1080p)紀錄片,使用 Wikimedia Commons 的公有領域圖片(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)
基礎網址: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 }