MiniMax 公式ビデオは何をしますか？

このスキルの scripts/minimax_video.py を使用して、MiniMax 公式 V2 インターフェースに直接接続します。デフォルトは国内サイト https://api.minimax.cn、国際サイトは https://api.minimax.io、デフォルトモデルは MiniMax-H3 です。通常、MiniMax の新しいタスクにはこのスキルを使用します。哪都通のタスクは元のクライアントでステータスを確認する必要があり、タスク ID はサービス間で移行できません。

設定

実際のスキルインストールディレクトリからスクリプトを特定します。優先的に ~/.config/minimax/venv/bin/python を使用します。プレーンテキスト、HTTPS、または mm_file:// 入力には Python 3.9+ のみが必要です。ローカル素材の検証とオプションの R2 には scripts/requirements.txt の依存関係が必要です。
認証情報は MINIMAX_API_KEY から読み取ります。環境変数が優先され、次に ~/.config/minimax/env を解析します。他のアプリのチャット認証情報は読み取らず、キーをスキル、コマンドライン、タスク記録に書き込みません。国内/国際サイトとツール環境については設定と復元を参照してください。
キーがない場合は、scripts/configure.py --region cn --gui を使用して macOS の非表示入力ボックスで設定します。他のシステムではユーザーのターミナルで非表示入力を行います。ユーザーにキーをチャットに送信するよう要求しないでください。ユーザーが環境変数を既に持っている場合は --from-env を使用し、ローテーションには --replace-key を使用します。
doctor --check-api は最近のタスクリストのみを読み取り、認証と V2 クエリインターフェースを検証します。残高、特定モデルの生成権限、または完成品質を証明するものではありません。インストール、設定、インターフェース調査は有料生成を許可しません。

パラメータと入力

モデル、非デフォルトパラメータ、またはマルチモーダル素材を選択する前に、公式インターフェースと機能を読み、哪都通のモデル ID、720p/960p の階層、または 4〜12 秒の制限を引き継がないでください。

デフォルトのサンプルは H3、4 秒、768P です。プレーンテキストのデフォルトは 16:9 で、最初/最後のフレームは入力画像によってアスペクト比が決まります。4 つの H3 モデルの解像度、長さ、参照比率の制限は異なるため、クライアントはモデルに応じて検証します。
--first-frame、--last-frame はそれぞれ最大 1 枚です。マルチモーダル参照には繰り返し可能な --ref-image、--ref-video、--ref-audio を使用します。最初/最後のフレームはマルチモーダル参照と混在できません。素材の順序を維持し、プロンプトで「参照画像1」「参照ビデオ1」などの役割を明確に指定します。
素材はローカルファイル、HTTPS URL、現在の公式アカウントの mm_file:// ハンドルをサポートします。ローカル入力は最初に不変のコピーを保存し、形式、サイズ、長さなどを検証します。リモート入力のメディア仕様は公式が検証し、ローカルで確認済みとは主張しません。
小さなローカル素材はデフォルトで --delivery inline を使用し、公式の data URI 形式で生成リクエストとともに送信されるため、サードパーティのホスティングは不要です。Base64 展開後のリクエスト総サイズは 64 MB を超えないようにしてください。ローカルの MOV や大きな素材は、明示的に --delivery r2 を使用してから host を実行できます。制限を回避するために、ユーザーの元のファイルを自動的にアップロード、トランスコード、または変更することはありません。
R2 モードでは、設定済みのプライベートバケットのみを使用し、ハッシュによってオブジェクトを再利用して匿名ダウンロードを検証します。アップロード前に、対象プロジェクトの素材とプライバシーに関する規約に従います。現在のタスクで許可された素材の範囲内でのみホスティングします。設定またはホスティングに失敗した場合は報告し、自動的に画像ホストを変更しません。

制作とステータス確認

ユーザーがビデオ生成を要求した場合、1 つの候補を完了します。バッチと追加の試行は、今回の規約に従います。各候補は新しいタスクディレクトリを使用し、優先的にプロジェクトで無視される tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/ に配置します。プロジェクトがない場合は、ワークスペースの一時ディレクトリまたはユーザー指定の場所を使用し、古いタスクを上書きしません。

doctor --check-api で設定を確認します。アクション、カメラワーク、キャラクター/プロップの制約、音声要件を UTF-8 プロンプトファイルに書き込み、prepare でプロンプト、公式パラメータ、サービスリージョン、入力コピーを固定します。このステップはオフラインで、ビデオは生成されません。
--delivery r2 でローカル素材がある場合のみ host を実行します。この操作は素材をプライベート R2 にアップロードし、MiniMax が署名付きリンクを使用できるようにします。インライン素材は直接 MiniMax に送信されます。
submit を 1 回実行します。クライアントは有料 POST の前に送信記録とリクエストハッシュを排他的に保存します。公式は文書化されたキーでべき等性を保証していないため、ローカルリクエスト UUID をサーバー側の重複排除の保証として使用できません。
独立した status でクエリを実行します。ステータスは queued / running / succeeded / failed / cancelled です。ホストが中断可能な待機を使用し、進行状況を伝達します。長いシェルコマンドで数分間ポーリングしないでください。
成功後、download で MP4 をダウンロード、検証し、ハッシュを保存します。ダウンロードに失敗した場合は、status / download のみを再試行します。期限切れのメディア URL は再クエリで更新できます。公式は直近 7 日間のタスククエリのみを提供するため、速やかにディスクに保存する必要があります。
会話をまたいで復元するには、まず inspect --job を実行し、次に status / download を実行します。いかなる submission.json も再送信を防ぎます。タイムアウト、切断、5xx、または ID が返されない場合は結果が不明確であり、証拠を保持します。読み取り専用の tasks で補助的に確認できますが、モデルと時間が近いだけでは同じタスクであるとは証明できません。失敗または結果不明の場合、追加の有料候補を自動的に作成しません。

コマンド例（変数はすべて実際の絶対パスを表します。JOB はまだ存在してはいけません）：

"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --first-frame "$FIRST_FRAME" --duration 4 --resolution 768P
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"

プレーンテキストの場合は --first-frame を省略し、必要に応じて --ratio を指定します。最初/最後のフレームには --last-frame を追加できます。マルチモーダル参照には対応する --ref-* パラメータを使用します。R2 モードでは prepare 時に --delivery r2 を追加し、submit 前に host --job "$JOB" を実行します。完全なオプションはスクリプトの --help で確認できます。

納品

再生可能なローカル video.mp4 とタスクディレクトリを提供し、絶対パスでビデオを表示します。実際のモデル、長さ、解像度、アスペクト比、音声パフォーマンス、および元の速度のビデオ、最初/最後のフレーム、キャラクターの一貫性を確認したかどうかを説明します。HTTP 成功は視覚的な承認合格を意味しません。

タスク記録には、プロンプト、Base64 素材、署名付き URL、実際のタスク ID が含まれ、現在のユーザーのみが読み取れます。全体をチャットに貼り付けたり、Git にコミットしたりしないでください。コンソールにはタスクフィンガープリントが表示されます。公式 API Bearer は許可された公式 API ホストにのみ送信され、完成品とそのすべてのリダイレクトは匿名 HTTPS でダウンロードされます。

MiniMax 公式ビデオ