Hourlore: ナレーション付き5~15分ドキュメンタリー制作ツール
Hourlore (https://hourlore.com) は、1行のトピックを調査に基づいたナレーション付きの16:9(1080p)ドキュメンタリーに変換します。Wikimedia Commonsのアーカイブ画像(パブリックドメイン、CC0、CC BY、CC BY-SA)、アニメーション地図フライト、ナンバーカード、単語ごとのキャプションを使用します。
始める前に
https://hourlore.com/accountからAPIキーを取得し、ユーザーのHOURLORE_API_KEY環境変数(hl_...)に保存してください。キーをソースファイルにハードコードするようユーザーに依頼しないでください。- まずプレビューし、クレジットを消費する前に確認を取ってください:
create_storyboard_previewは無料(アカウントあたり1日最大10プレビュー)で、約25秒で8~12のオープニングショットを返します。create_documentary_filmは 25クレジット(5分)、50クレジット(10分)、または 75クレジット(15分) を消費します(5クレジット = 1分)。フルレンダリングをキューに入れる前に、トピック、尺(5、10、15分)、ナレーター(olivia女性 またはowen男性)を必ずユーザーに確認してください。
- クリエイティブ・コモンズの帰属表示(
CC BY/CC BY-SA)を保持するため、返されたdescription_textを公開された動画と一緒に保存しておいてください。
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を提供します。 - ユーザーがキューイング直後に気が変わった場合は、
cancel_documentary_film(film_id)を呼び出します。cancelableがtrueの間は、保持されていたクレジットが返金されます。
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 }