HD70X/nxtpath-minimax-video

哪都通 MiniMax 動画

専用クライアント scripts/nxtpath_minimax_video.py、固定ゲートウェイ https://api.nxtpath.ai/v1、デフォルトモデル minimax/minimax-h3 を使用します。パラメータは哪都通の H3 チャンネルに準拠し、MiniMax 公式直結インターフェースや Seedance のパラメータは適用しません。確認済みのインターフェースおよび検証範囲については インターフェース根拠 を参照してください。

設定と入力

• 本マシンの NXTPATH_API_KEY を再利用し、環境変数を優先、なければ ~/.config/nxtpath/env を解析します。NXTPATH_ENV_FILE でファイルパスを上書き可能。Claude、Codex、Grok のチャット認証情報は読み取らず、キーをコマンドラインやタスク記録に含めません。
• このスキルの実際のディレクトリからクライアントを特定します。~/.config/nxtpath/venv/bin/python を優先使用。テキストまたは HTTPS 画像入力には Python 3.9+ のみ必要です。ローカル画像のホスティングには scripts/requirements.txt 内の boto3 も必要です。設定の説明は 設定と復元 を参照してください。
• まず対象プロジェクトの素材とプライバシー規約を読みます。各候補は新しいタスクディレクトリを使用し、デフォルトはプロジェクトの無視される tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/ に配置。プロジェクトがない場合は、現在のワークスペースの一時ディレクトリまたはユーザー指定の場所を使用します。古いタスクを上書きしたり、正式なリソースを自動的に置き換えたりしません。
• デフォルトのサンプルは 4 秒、720p、16:9です。長さは 4～12 の整数秒、解像度は 720p / 960p / 2k のみ、アスペクト比は 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 をサポート。
• 3 種類の入力：テキストのみ。--first-frame または --last-frame （または両方）は最大 1 枚ずつ。繰り返し指定可能な --ref-image 通常参照画像。最初/最後のフレームと通常参照画像は併用不可。参照音声や参照動画は非対応。通常参照画像は最初/最後のフレームの役割を持ちません。
• 画像は HTTPS URL、またはローカルの PNG/JPEG/WebP（各 20 MiB まで）を使用。data URL は拒否。巨大画像は事前に縮小コピーを保存し、ユーザーのオリジナルは変更しません。

生成と継続調査

ユーザーが明確に動画生成を要求した場合に 1 つの候補を完了。バッチとリトライ回数は今回の取り決めに従います。設定の確認、インターフェースの調査、またはスキルの作成だけでは有料生成を許可しません。追加試行の取り決めがない場合、失敗タスクを自動再生成したりモデルを変更したりしません。

1. doctor --check-api で読み取り専用の認証情報、model_available、model_supported を確認。いずれかのモデルチェックが false の場合、送信を中止し、ディレクトリまたは設定を確認。
2. ユーザーの要求に従ってアクション、ショット、長さ、保持すべきキャラクター／小道具を整理し、プロンプトを UTF-8 ファイルに書き込みます。prepare でプロンプト、パラメータ、入力のスナップショットを固定。このコマンドはオフラインで実行され、動画は生成しません。
3. ローカル画像がある場合は host を実行。設定済みのプライベート R2 を使用し、コンテンツハッシュオブジェクトを再利用、24 時間の GET 署名を発行し、ダウンロードハッシュを検証。この操作により入力が R2 と動画プロバイダーに送信されます。ホスティングに失敗した場合は停止し、自動的に公開画像ホストやアカウントに切り替えません。テキストのみまたは既存の HTTPS 画像の場合はこの手順をスキップできます。
4. submit を 1 回実行。これは有料 POST の前に排他的な提出記録と冪等キーを永続化し、その後独立した status で照会します。サービスステータスは Pending / Running / Success / Failure / Expired。待機中はホスト可能な中断待機を行い、進捗を伝達し、長時間のシェル呼び出し内で数分間ループしません。
5. Success 後、download で MP4 をダウンロードし検証。ダウンロード失敗時は再ダウンロードのみを試行。Failure / Expired はそのタスクの終了状態であり、結果を報告し、これにより自動的に新しい有料タスクを作成してはいけません。
6. 会話をまたいだ復元には元のジョブパスを使用し、まず inspect、その後 status / download。提出記録、タイムアウト、切断、またはタスク ID 欠落がある場合は再 POST してはいけません。結果不明の場合はプライベート記録に基づき提供元に確認し、新しい attempt で回避してはいけません。

コマンド例（PY、CLIENT、JOB、PROMPT_FILE、画像変数は実際のパスを指します。JOB はまだ存在しない必要があります）：

"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --first-frame "$FIRST_FRAME" --last-frame "$LAST_FRAME" --duration 4 --resolution 720p --ratio 16:9
"$PY" "$CLIENT" host --job "$JOB"
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"

最初のフレームのみの場合は --last-frame を省略。通常参照画像の場合は --ref-image で 2 つのフレームパラメータを代替。テキストから動画を生成する場合はすべての画像パラメータと host を省略。本マシンの NXTPATH_MINIMAX_MODEL または明示的な --model では、サポートされている H3 ID のみを選択可能で、他のチャンネルに自動的にフォールバックしません。

納品

再生可能なローカル video.mp4 とタスクディレクトリを提供し、絶対パスで動画を表示。実際のパラメータ、および元速度、アクション、最初と最後を確認したかどうかを説明。HTTP 成功は画質やキャラクター一貫性を証明しません。インターフェースが最初と最後のフレームをサポートしていても、ピクセル単位での保証はなく、結果は実際の動画に基づきます。

プロンプト、署名付き画像 URL、タスクハンドル、応答は現在のユーザーのみが読み取り可能な記録に保存。これら全体をチャットに貼り付けたり Git にコミットしたりしないでください。コンソールにはタスクハンドルのフィンガープリントのみ表示。動画 Bearer はこのゲートウェイの対応するアーティファクトハンドルにのみ送信され、リダイレクト後の HTTPS メディアダウンロードは匿名リクエストを使用します。