動画生成
Elftia の動画生成機能は、テキストの説明や参考画像から AI を使ってショート動画を生成することができます。主要な動画生成プロバイダーをいくつか統合しており、時間のかかる動画レンダリング処理には非同期ポーリングモデルを採用しています。
用途
- テキストの説明からショート動画クリップを生成する
- 静止画を動画に変換する（画像から動画モード）
- ソーシャルメディアやプレゼンテーション用のクリエイティブな動画を素早く生成する
- 異なるプロバイダーの生成結果を比較する
対応プロバイダー
| プロバイダー | 特長 | API タイプ |
|---|---|---|
| Kling AI | 高品質な動画生成、複数の解像度に対応 | 非同期 API |
| OpenAI (Sora) | OpenAI の動画生成モデル | 非同期 API |
| Replicate | オープンソースモデルのホスティングプラットフォーム、豊富なモデル選択肢 | 非同期 API |
| VolcEngine | Volcengine（火山エンジン）の動画生成サービス | 非同期 API |
| Wan | Wan 動画生成 | 非同期 API |
| カスタム（Unified） | 統一インターフェースに対応するサードパーティサービス | 非同期 API |
プロバイダーの設定
手順
- 設定 > メディアプロバイダー > 動画 を開く
- プロバイダーを選択する
- API Key を入力する（一部のプロバイダーはアクセスキーや他の認証情報も必要）
- （任意）API エンドポイントをカスタマイズする
- デフォルトモデルを選択する
- 保存して有効化する
プロバイダー設定テーブル
| 設定 | 説明 | 必須 |
|---|---|---|
| API Key | プロバイダーの API キー | はい |
| API エンドポイント | カスタム API アドレス | いいえ（デフォルトは公式アドレス） |
| デフォルトモデル | デフォルトで使用する動画モデル | いいえ |
| 有効 | このプロバイダーを有効にするか | はい |
動画を生成する
手順
- 動画生成機能を選択する
- プロバイダーとモデルを選ぶ
- 動画を説明するテキストプロンプトを入力する
- （任意）参考画像をアップロードする（画像から動画モード）
- 生成パラメーターを設定する
- 生成 をクリックする
- 非同期タスクの完了を待つ
生成パラメーター
パラメーターはプロバイダーによって異なりますが、一般的なパラメーターは以下の通りです:
| パラメーター | 説明 | 備考 |
|---|---|---|
| プロンプト | 動画の内容を説明するテキスト | 必須 |
| 参考画像 | 動画の開始フレームとして使用する画像 | 任意（画像から動画モード） |
| 長さ | 動画の長さ（秒） | プロバイダーによって異なる |
| 解像度 | 動画の解像度 | 例: 720p、1080p |
| FPS | 1秒あたりのフレーム数 | プロバイダーによって異なる |
非同期ポーリングモデル
動画生成には通常かなりの時間（数十秒から数分）がかかるため、Elftia は非同期ポーリングメカニズムを採用しています:
生成リクエストを送信 → タスク ID を受け取る → 定期的にステータスをポーリング → タスク完了 → 動画をダウンロード
動作の説明
- リクエストの送信 — プロバイダー API に生成リクエストを送信し、タスク ID を受け取る
- ステータスのポーリング — システムが定期的にタスクのステータスを自動的に確認する（通常5〜10秒ごと）
- タスク完了 — ステータスが完了に変わると、生成された動画ファイルが自動的にダウンロードされる
- 結果の表示 — 動画が UI に表示され、再生できる状態になる
待機中、UI には現在のタスクステータスと推定残り時間（プロバイダーが対応している場合）が表示されます。
自動リトライ
生成中に一時的なエラーが発生した場合、システムは自動的にリトライします:
| 設定 | 説明 | デフォルト |
|---|---|---|
| リトライ回数 | 失敗後の最大リトライ回数 | 2 |
| リトライ間隔 | 指数バックオフを使用 | 1秒から開始 |
動画のグローバル設定
| 設定 | 説明 | デフォルト |
|---|---|---|
| 同時実行数 | 同時に実行できる動画生成タスクの数 | 1 |
| リトライ回数 | 生成失敗時の自動リトライ回数 | 2 |
これらのパラメーターは 設定 > メディアプロバイダー > 動画 > グローバル設定 で調整できます。
プロバイダー選択ガイド
| ニーズ | おすすめのプロバイダー |
|---|---|
| 高品質な商業用動画 | Kling AI |
| OpenAI エコシステムとの統合 | OpenAI (Sora) |
| 柔軟なオープンソースモデルの選択 | Replicate |
| 安定したアクセス（中国国内） | VolcEngine |
よくある質問
| 質問 | 解決策 |
|---|---|
| タスクがずっと「待機中」のまま | 動画生成には時間がかかります。しばらくお待ちください。高品質なモデルは数分かかる場合があります |
| タイムアウトエラーで生成に失敗する | プロバイダーの負荷が高い可能性があります。しばらく後に再試行してください |
| 動画が再生できない | お使いのシステムでサポートされている動画フォーマットか確認してください。外部プレイヤーをお試しください |
| API キーの検証に失敗する | API キーが正しいか、アカウントに十分なクォータがあるか確認してください |
| カスタムプロバイダーが互換性なし | API インターフェースが統一インターフェース仕様（Unified フォーマット）に準拠しているか確認してください |