リリースノート

AI 動画生成のオフピーク時間帯リトライ案内。 上流の動画キューが満杯（HTTP 503 / queue-full）のとき、失敗パネルとタスク作成トーストが、上流が歴史的に安定している時間帯を提示するようになりました。これは推測ではなく実測

スタイルプリセット選択に現在の適用状態を表示。 プリセットのドロップダウンをネイティブ select 風のコントロールに作り直しました。トリガーには現在選択中のプリセット名が表示され、リストでは適用中の項目にチェックマークが付き、フィールド

ffmpeg が見つからない場合に、読みやすいローカライズ済みエラーを表示。 使用可能な ffmpeg 実行ファイルが見つからない場合、タスクはユーザーの UI 言語で明確なメッセージとともに失敗するようになり、問題点と対処方法（ffmpe

上流 API エラーのトレンド。 HTTP ステータスコードを含むエラーを、タスク単位で集計するようになりました。集計軸はステータスコード、モデル種別（chat / image / video）、API メソッドで、タスク詳細 API から

Agnes のキュー飽和に耐える。 Agnes が 503 video_queue_full で送信を拒否した場合（無料の Video 2.5 Flash キューは 10 分以上満杯のままになることがあります）、アプリは専用のトラックで再試

401 を防ぐ、より明確なキー／ドメイン設定。 API Key パネルは取得元ごとに説明を表示するようになりました。Web UI で追加したキーは各自のドメインに紐付けでき（ドメイン自動検出 の対象にもなります）、一方 .env / 環境変

設定でのプロバイダー構成ガイド。 サードパーティのテキストモデルプロバイダーを追加する際、設定パネルに実用的なヒントが表示されるようになりました。推奨プロバイダー（AMD Radeon Cloud）とその OpenAI 互換エンドポイント、

カスタムテキストモデルプロバイダー（OpenAI 互換 / Anthropic 互換）。 base URL + API key を設定し、対応する 2 つのワイヤプロトコル（openai-completions、anthropic-mess

スタイル／プロンプトのプリセットライブラリ。 クリエイティブ動画とポエトリー動画の形式で、スタイル入力欄の横にスタイルピッカーが表示されるようになりました。6 カテゴリ（フォトグラフィック、シネマティック、オリエンタル、絵画、アニメーション

堅牢な原稿生成。 原稿の長尺動画用プロンプト作成中、1 つのシーンで失敗してもタスク全体が中断されなくなりました。失敗したシーンはスキップされ、残りのシーンは正常に生成され、再開時には失敗したシーンだけが再生成されます——一時的なモデルエラ

シンプルモード（「一键创作」）——1つのアイデアから完成したクリエイティブ動画へ。 メインUIに新しいトップレベルのタブが追加され、3ステップのウィザードを提供します：アイデアを入力し、シーンごとのプロンプトとナレーション付きの絵コンテプレ

ローカルネットワークとDNS障害の読みやすい診断。 ダウンロード段階でちょうど終了してしまった長時間実行のクリエイティブ・原稿・アンカー・詩のジョブは、以前は RetryError[<Future ... raised Connection

全般の機能最適化 —— Web インターフェース全体を最適化し、よりスムーズで信頼性の高い操作を実現しました。

Docker でのデジタルヒューマン（アンカー）動画の結合/合成ステップが失敗しなくなりました —— アンカータスクは、プレゼンタークリップのループ再生と、それとナレーション音声・字幕を合成する際にクラッシュしていましたが、根本原因は恒久的

agnes-3.0-flash が既定のテキストモデルに —— AI 脚本作成、シーン用プロンプト生成、詩の分割、原稿のセグメンテーションなど、LLM を利用する全機能が Agnes AI 最新の推論モデル agnes-3.0-flash

画像モデルの選択に対応 — 参照画像・末尾フレーム・単体の画像生成に使う画像モデルを「設定」パネルから直接選べるようになりました。従来はビルトインの既定モデルに固定されていました。

Google Analytics の計測が正常に動作 — GA4 のブートストラップがデータレイヤーに送信していたコマンド形式を Google タグが暗黙のうちに無視していたため、page_view もイベントも一切送信されていませんでした

キーごとのドメインバインディング — プロジェクト設定に保存された各 API キーが独自のアクセスドメイン（com / cn / cn_bak）を持てるようになり、グローバルサイトで発行されたキーと中国国内サイトで発行されたキーが共存し、正

動画合成時の「ffmpeg not found」エラー（FileNotFoundError）を修正 — Windows や ffmpeg が PATH にないシステムでは、クリエイティブ／原稿／アナウンサー／詩の合成（連結、音声オーバーレイ

クリエイティブ／原稿タスクのプレビュー（"dry-run"）エンドポイント — POST /api/creative/preview-script と POST /api/manuscript/preview-split により、本タスクを

v6 最適化ロードマップが完全完了（29/29 項目） — v6 ロードマップの全バッチが出荷完了しました：

フィードバックと診断レポートのローカライズ —— 診断レポートの見出し、フィールド名、生成される GitHub Issue テンプレートが中国語でハードコードされなくなりました。UI 言語（22言語）に従うため、フィードバックパネルのフィー

Agnes Video 2.5 / 2.5 Flash に対応 —— 最新の動画生成モデルに完全対応しました。Video 2.5 Flash は期間限定で無料（720P、$0/秒）、Video 2.5 には有料の品質ティア（720P / 9

失敗したタスクのパネルは、行き止まりのエラー行ではなく、明確なアクション手順を示すようになりました：

チェックポイントでの一時停止 — パイプラインは成果物生成後にチェックポイントで停止し、操作を待って、最後に確認した段階から続行します。

v5.7.3 アップグレード後の白画面を修正 — 分析機能の変更を master にマージする際、git の自動マージが新しいミニファイ済みJSバンドルを古いもののリネームと誤認し、出荷バンドルに <<<<<<<< / >>>>>>>> の

生成動画のモード別分析 — task_completed と task_failed のGA4イベントに、シンプル動画タスク（t2v / i2v / ti2vid / keyframes）向けの mode パラメータが追加されました。cre

進捗パネルで中間成果物の表示が復活 — v5.7.0 のフロントエンド再構築以降、タスク実行中に中間成果物（ストーリー、参照画像、シーンビデオ、字幕など）が表示されなくなりました。進捗パネルはタスク開始時に成果物を読み込み、ポーリング中に各

npm publish ステップが失敗：printf: --: invalid option — リリースワークフローの「Prepare npm README」ステップは printf '---\n...' を使用しており、そのフォーマット

複数 API キーのローテーションとスループット向上 — 複数の Agnes API キーを設定可能（env + 設定ファイル、自動重複排除）。リクエストは KeyRing でキー間をローテーションし、429 レート制限時は即座に次のキーへ

ライト/ダークデュアルモード — Midnight デザインシステムがワンクリックの切り替えでライト・ダーク両テーマに対応しました。

Midnight デザインシステム — 雰囲気のあるダークテーマ、洗練されたタイポグラフィ、間隔、視覚階層を全タスクタブ・設定パネル・進捗ビューに採用した完全なフロントエンド再設計。

UI とスクリプトの紹介リンクが現在の公式サイトパスを指すようになりました（非推奨スラッグを削除）。

22言語UI — 公式サイトに合わせて言語サポートを22言語に拡張。

タスクフォームのプロンプト例 — 各タスクタイプのフォーム（シンプル／クリエイティブ／原稿／アンカー）にプロンプト例へのガイドリンクを表示。全13言語に対応。

web/ ルーティング層 — server.py をモジュール化されたルート層（web/routes/）に分割。構造とテスタビリティが向上。

オプションのGA4アナリティクス — ユーザー操作の追跡とエラー報告を提供。セットアップスクリプトがカスタムディメンションと主要イベントを自動設定します。

Agnesドメイン設定（com/cn） — Agnes APIのベースドメインを設定可能。.cn ドメインへの切り替えが、以前の API_ROOT 未定義エラーなしで機能するようになりました。

imageio-ffmpeg 依存関係を明示的に宣言。npm README にffmpegのセットアップが記載されました。

imageio-ffmpeg が明示的な依存関係になり、npm READMEにffmpegのセットアップが記載されたため、npm install -g free-short-video 後に動画連結が機能します。

Docker / npmページのクイックスタート — Docker Hubの概要とnpm READMEはどちらもクイックスタート（pull / run / npx free-short-video）で始まり、その後に現在のリリースの「新機能

Docker Hub の概要更新が 100 バイトの短い説明の制限を尊重するようになり、ページのタイトルと説明が正しく公開されるようになりました。

レジストリページのタイトル（GHCR / Docker Hub）が、製品ブランディングを統一するため Free Short Video に変更されました。

リリースワークフロー: npm publish はシェルチェックによってステップ内で保護されるようになりました。NPM_TOKEN がない場合は npm publish のみがスキップされ、Docker イメージのリリースをブロックしません

リリースワークフロー：npm のバージョンは npm pkg set で同期されます（detached HEAD では git commit を実行しないため）、npx free-short-video のバージョンがタグと一致し続けます。

単語レベルの字幕タイムライン (v2.0) — 字幕は edge_tts の単語レベルのキュー（正確な真実の情報源）に合わせられます。WhisperX の外部依存関係を削除し、字幕タイミングを正確かつ自己完結にしました。

全言語の字幕が一貫したレンダリングのため 2 行に制限されるようになりました。

モデルセレクター — UI 上でテキスト / 画像 / ビデオモデルを直接選択できます。新しい agnes-2.5-flash モデルにはテスト中（ベータ）の表示が付きます。

Docker Hub ページには簡潔な説明と完全な README ベースの概要が表示され、リリースのたびに自動で更新されます。

Docker Hub の概要更新が 100 バイトの短い説明 API 制限を尊重するようになり、説明と README が正しく公開されます。

GHCR のプルパスを ghcr.io/lcy362/free-short-video:<version> に修正しました。無効な orphan-cleanup ステップを削除しました。

リリースワークフロー：孤児クリーンアップ手順が if 条件内でシークレットを参照しなくなり、マルチアーキテクチャイメージの公開が安定します。

GHCR イメージは現在 GITHUB_TOKEN でプッシュされ、パッケージがこのリポジトリに紐付き、マルチアーキテクチャのプルコマンドが安定して動作します。

Docker データ永続化 — イメージは /app/.working_dir と /app/.agnes_config に VOLUME を宣言するようになりました。ワンコマンド起動とバインドマウント実行方法を文書化し、出力と設定がコンテ

リリースノートで GHCR と Docker Hub の両方のプルコマンドを表示するようになりました。GHCR のタグ形式を修正し、v プレフィックスを削除しました（例: ghcr.io/lcy362/free-short-video:4.

Docker ビルドはデフォルトで公式 PyPI ソースを使用するようになりました。中国本土内のビルドでは、ビルド引数によってローカルミラーを選択できます。

リソースナビゲーションバー — ヘッダー下のクイックアクセスリンク（デモ、ホーム、ガイド、FAQ、GitHub）。

詩動画タスクタイプ — 新設の POST /api/tasks/poetry: LLMが詩を複数のシーン（原句 | 映像の説明形式）に分割し、各行をTTSナレーションで読み上げ、シーンをt2vクリップとして生成、字幕をナレーションに時間同期

中間成果物ビューア — タスク詳細パネルで各ステップの中間出力（プロンプト/画像/動画）を表示。モード（クリエイティブ/原稿/アンカー）で絞り込み可能。カスケード削除は対応する状態フィールドをクリアし、下流ステップをリセットし、ファイルをク

6 つの新しい UI 言語 — ドイツ語 (Deutsch)、フランス語 (Français)、オランダ語 (Nederlands)、スペイン語 (Español)、ポルトガル語 (Português)、イタリア語 (Italiano) が

動画ウォーターマーク — 生成動画に自動でウォーターマークを重ね合わせ。言語検出とUIトグルに対応。

構造化シーン設定 — 自由テキストの user_requirement を明示的なパラメータに置き換え：duration_source（手動 / アイデア説明から抽出）、scene_count、uniform_duration / scen

バイリンガル脚本 — 全 14 個の脚本メタプロンプトが中国語/英語の切り替えに対応。

マルチワークスペース管理 — Web UI から直接、複数の作業ディレクトリを追加・切り替え・管理可能。各ワークスペースは生成した動画、アップロード、設定を独自に保持します。

マルチタスク並行制御 — 重み付きセマフォにより複数のタスクが自動的にキューイングされながら並行実行されます。新しいタスクは UI をブロックせず待機列に入ります。

字幕とナレーションの独立制御 — SubtitleConfig を AudioConfig と同格に昇格し、それぞれ独立した enabled スイッチを用意。4 つの組み合わせモード（ナレーション+字幕、ナレーションのみ、字幕のみ、無音）に

i2i終端フレームパイプライン — 画像モデルを agnes-image-2.1-flash に統一。i2i配列API。キャラクター参照画像のサイズ正規化。プログラム的なプロンプト注入でシーン間のキャラクター外観を保持。複数画像による終端フ

APIキーのクリア/リセット — Web UI でキーを完全にクリアできるようになりました（上書きだけでなく）。

共通基盤を持つ3つのタスクタイプ — シンプル動画（単一プロンプト→Agnes Video APIで1本の動画、t2v/i2v/ti2vid/keyframes）、クリエイティブ動画（AI脚本家→ストーリーボード→シーン別動画→edge_t

Web UI — ワンクリック起動、すべてブラウザ上で操作、コマンドラインは不要。