プロジェクト概要
MiniMax H3 Cloud for Codexは、クラウドGPUで動作する動画生成プラグインです。Codexで要件を伝えるだけで、プラグインが計算リソースの選択、インスタンスの作成または起動、ComfyUI Runtimeの準備、ワークフローの送信、MP4のダウンロード、タスク完了後のシャットダウンまで実行します。
現在は優云智算プラットフォームに対応しており、READMEでは今後ほかのプラットフォームにも対応予定とされています。プラグイン自体は無料ですが、利用するGPU、システムディスク、イメージなどのクラウドリソースについては、優云智算から直接料金が請求されます。
ライセンスに関する注意：リポジトリにはMiniMax H3のモデルウェイトは含まれていません。モデルはMiniMax H3 Community License Agreementの対象であり、現行の規約ではEU、英国、韓国、米国などの地域が明確に除外されています。除外対象地域のユーザーは、まずMiniMaxから個別の許諾を取得し、利用前に所在地、用途、プラットフォームサービスが関連条項に適合していることを確認する必要があります。
主な機能
3種類の動画生成方式
- テキストから動画生成：テキストプロンプトに基づいて動画を生成します。
- キーフレームから動画生成：開始フレーム、終了フレーム、または開始・終了フレームの両方を指定できます。
- 参照画像から動画生成：1～9枚の参照画像に対応しています。
クラウドワークフローの自動化
プラグインはGPUの価格と在庫の確認を支援し、ユーザーが設定を確認した後、計算リソースインスタンスの起動、ComfyUI Runtimeの準備、動画ワークフローの送信、結果のダウンロード、インスタンスの停止など、後続の処理を実行します。
料金とシャットダウン保護
有料リソースを作成する前に、プラグインは必ずユーザーの確認を取得します。デフォルトでは30分後の保険用シャットダウンを設定し、1回のタスクが完了または失敗すると直ちにシャットダウンして、インスタンスの稼働継続による追加料金のリスクを抑えます。
ローカル認証情報の管理
プラグインは、API KeyをCodexの会話に送信するようユーザーに求めません。優云智算の認証情報はCompShare CLIによって本機に非表示で保存され、プラグインの設定と生成した動画もプラグインのインストールディレクトリ外に保存されます。そのため、プラグインを更新してもこれらのユーザーデータは上書きされません。
インストール前の準備
インストールを開始する前に、ローカル環境が以下の条件を満たしていることを確認してください：
- OSがmacOSまたはLinuxである。
- プラグイン機能に対応したCodexがインストールされている。
- Node.jsのバージョンが20以上である。
- システムで
sshとffprobeを使用できる。 - 優云智算のアカウントとAPI Keyを所有している。
- CompShare CLIのバージョンが0.3.5以上である。
CompShare CLIのインストール
PyPIからCompShare CLIをインストールまたはアップグレードし、バージョンを確認します：
python3 -m pip install --upgrade compshare-cli
compshare --version出力されたバージョンが0.3.5以上であることを確認してください。CompShare CLIのプロジェクトと詳細については、CompShare CLI GitHubリポジトリを参照してください。
MiniMax H3 Cloudプラグインのインストール
まずプロジェクトリポジトリをCodex Marketplaceに追加し、対応するプラグインをインストールします：
codex plugin marketplace add Sac-Y/MiniMax-H3-Cloud --ref main
codex plugin add minimax-h3-cloud@sac-y-minimax-h3コマンドの実行が完了すると、CodexでMiniMax H3 Cloudを呼び出せるようになります。初回実行時には、案内に従ってアカウント認証情報、GPU設定、動画パラメータを設定します。
初回利用の流れ
- クラウドプラットフォームにログイン：優云智算に登録またはログインし、公式CLIを使ってAPI Keyを本機に非表示で保存します。API KeyをCodexの会話に貼り付けないでください。
- GPUを選択：現在のGPUのリアルタイム価格と在庫を確認し、要件と予算に合う構成を選択します。
- 生成パラメータを指定：プロンプトを送信し、生成方式に応じて画像を指定します。あわせて画角、長さ、解像度を設定します。
- 料金を確認：動画パラメータと予想料金を確認します。確認後にのみ、プラグインが有料リソースを作成します。
- 生成を待つ：プラグインが実行環境を自動で準備し、ワークフローを実行してMP4をダウンロードします。
- 結果を確認：タスク完了後、Codexで動画を再生し、MP4ファイルをダウンロードできます。
基本的な使用例
以下は、Codexで指定できる要件の例です。具体的なオプションと利用可能な構成は、初回実行時に表示されるプラグインの案内に従ってください。
例1：テキストから動画を生成
MiniMax H3 Cloudを呼び出して、夕暮れの海辺の動画を生成してください。カメラはゆっくり前進し、波は穏やかで、全体を映画のような暖色調にしてください。画角、長さ、解像度、GPUの選択も案内してください。プラグインは要件に基づいてパラメータ収集とGPU選択のフローに進み、リソースを作成する前に予想料金を表示します。
例2：開始フレームと終了フレームを使用
MiniMax H3 Cloudを使い、指定した開始フレームと終了フレームに基づいて動画を生成してください。主体の一貫性を保ち、実行前に動画パラメータと予想料金を確認させてください。キーフレーム方式では、開始フレームのみ、終了フレームのみ、または開始・終了フレームの両方を指定できます。
例3：複数の参照画像を使用
MiniMax H3 Cloudを呼び出し、指定した参照画像を使って動画を生成してください。画角、長さ、解像度、計算リソースの設定も案内してください。参照画像から動画を生成する方式では、1～9枚の参照画像に対応しています。送信前に画像数が対応範囲内であることを確認してください。
設定と出力先
プラグインはデフォルトで設定を以下に保存します：
~/.config/minimax-h3-cloud/config.json生成した動画はデフォルトで以下に保存されます：
~/.local/share/minimax-h3-cloud/outputs/これら2つのディレクトリはいずれもプラグインのインストールディレクトリ外にあるため、プラグインを更新しても設定や生成済み動画は上書きされません。バックアップが必要な場合は、これらのディレクトリ内の必要なファイルを個別にコピーできます。
高度な使用方法と注意点
リアルタイム価格と在庫を先に比較する
クラウドGPUの価格と在庫はリアルタイムで変動します。タスクを開始する前に、予算、在庫、動画の要件を考慮して構成を選択してください。条件に合うリソースがない場合、プラグインはGPU選択のステップに戻り、ユーザーが確認していない構成へ黙って切り替えることはありません。
有料リソースの確認情報を慎重に確認する
プラグイン自体は無料ですが、クラウドプラットフォームはGPU、システムディスク、イメージなどのリソースに料金を請求します。リソースの作成を確認する前に、選択したGPU、予想料金、動画パラメータを確認し、設定ミスによる不要な支出を避けてください。
自動シャットダウンでコストを管理する
プラグインはデフォルトで30分後の保険用シャットダウンを提供し、1回のタスクが完了または失敗すると直ちにシャットダウンします。それでも、タスクの状態とクラウドプラットフォームのリソースページを確認し、インスタンスが想定どおり停止したことを確認してください。
会話中にAPI Keyを公開しない
API KeyはCompShare CLIを通じて本機に保存し、Codexの会話、ログ、スクリーンショット、公開された質問などに送信しないでください。プラグインの通常のフローで、チャット内容への認証情報の入力を求めることはありません。
入力タイプに応じて生成方式を選ぶ
- アイデアの説明だけがある場合は、テキストから動画生成を使用します。
- 開始または終了の画面を制御したい場合は、キーフレームから動画生成を使用します。
- 複数のビジュアル素材を参照したい場合は、参照画像から動画生成を使用し、画像数を1～9枚に抑えます。
使用前にモデルのライセンスを確認する
プラグインのコードはMIT Licenseですが、モデルとワークフローにはそれぞれライセンス要件があります。MiniMax H3 Community License Agreementを確認するだけでなく、リポジトリ内の第三者ライセンスに関する説明も読み、自身の地域と用途が要件を満たしていることを確認してください。
よくある質問
プラグインにMiniMax H3のモデルウェイトは含まれていますか？
含まれていません。READMEには、リポジトリがMiniMax H3のモデルウェイトを提供していないことが明記されています。
Windowsで使用できますか？
READMEに記載されている対応環境はmacOSまたはLinuxであり、Windowsへの対応は明記されていません。
現在、どのクラウドプラットフォームに対応していますか？
現在は優云智算にのみ対応しており、今後ほかのプラットフォームにも対応する予定です。
GPUが在庫切れの場合、別の構成に自動変更されますか？
変更されません。条件に合うリソースが見つからない場合、プラグインはGPU選択のステップに戻り、確認なしに別の構成へ切り替えることはありません。
生成した動画はどこに保存されますか？
デフォルトでは~/.local/share/minimax-h3-cloud/outputs/に保存されます。
まとめ
MiniMax H3 Cloud for Codexは、クラウドGPUの選択、ComfyUI Runtimeの準備、動画ワークフローの実行、MP4のダウンロード、インスタンスのシャットダウンをCodexの会話フローに統合します。依存関係のインストールとローカル認証情報の設定が完了すれば、テキスト、キーフレーム、または1～9枚の参照画像を使って動画を生成できます。実際に使用する際は、モデルのライセンス、リアルタイムのリソース価格、有料リソースの確認、API Keyの安全性に注意してください。