哪都通 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 的聊天憑證，不把金鑰放在命令列或任務記錄中。 - 從本 skill 實際目錄定位客戶端。優先使用
~/.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。
- 三種輸入：僅文字；
--first-frame和/或--last-frame各至多一張；可重複的--ref-image普通參考圖。首尾幀與普通參考圖不能混用，不支援參考音訊或參考影片。普通參考圖不具有首尾幀角色。 - 圖片使用 HTTPS URL，或本地 PNG/JPEG/WebP（每張至多 20 MiB）。拒絕 data URL。超大圖片需要先另存縮小副本，不改使用者原圖。
製作與續查
使用者明確要求生成影片時完成一條候選；批量和返工次數沿用本次約定。僅檢查配置、研究接口或建立 skill 不授權付費生成。沒有約定額外嘗試時，不自動重生成失敗任務或更換模型。
- 用
doctor --check-api唯讀核對憑證、model_available和model_supported；任一模型檢查為 false 時停止提交，核實目錄或配置。 - 按使用者要求整理動作、鏡頭、時長和需要保持的角色／道具，將提示詞寫入 UTF-8 檔案。用
prepare凍結提示詞、參數與輸入快照；此命令離線執行，不生成影片。 - 有本地圖片時執行
host，使用已配置的私有 R2，複用內容雜湊物件、簽發 24 小時 GET 並核對下載雜湊。此操作會將輸入傳給 R2 和影片提供商；託管失敗時停止，不自動換公開圖床或帳號。僅文字或已有 HTTPS 圖片可跳過此步。 - 執行一次
submit。它在付費 POST 前持久化排他提交記錄及冪等金鑰；隨後用獨立的status查詢。服務狀態為Pending/Running/Success/Failure/Expired。等待使用宿主可中斷等待並保持進度溝通，不在長 shell 呼叫裡迴圈數分鐘。 Success後用download下載並校驗 MP4。下載失敗只重試下載；Failure/Expired為該任務的終態，報告結果，不能因此自動新建付費任務。- 跨對話恢復使用原 job 路徑，先
inspect，再status/download。存在提交記錄、超時、斷線或缺少 task 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 取代兩個幀參數；文生影片時省略全部圖片參數和 host。本機 NXTPATH_MINIMAX_MODEL 或顯式 --model 僅可選擇已支援的 H3 ID，不自動回退到其他通道。
交付
交付可播放的本地 video.mp4 和任務目錄，用絕對路徑展示影片。說明實際參數，以及是否審看了原速、動作和首尾；HTTP 成功不能證明視覺品質或角色一致性。接口支援首尾幀不等於逐像素保證，結果以實際影片為準。
提示詞、簽名圖片 URL、任務句柄和回應保存在僅當前使用者可讀的記錄中；不要整份貼進聊天或提交 Git。控制台僅展示任務句柄指紋。影片 Bearer 只傳送到本閘道器的對應 artifact 句柄，跳轉後的 HTTPS 媒體下載使用匿名請求。