MiniMax 官方影片
使用本技能的 scripts/minimax_video.py 直連 MiniMax 官方 V2 介面。預設國內站 https://api.minimax.cn，國際站為 https://api.minimax.io，預設模型 MiniMax-H3。一般 MiniMax 新任務使用本技能；哪都通任務必須由原客戶端續查，任務 ID 不跨服務遷移。
配置
- 從實際 skill 安裝目錄定位指令碼。優先使用
~/.config/minimax/venv/bin/python；純文字、HTTPS 或mm_file://輸入僅需 Python 3.9+。本機素材校驗和可選 R2 需要scripts/requirements.txt中的依賴。 - 憑證讀取
MINIMAX_API_KEY，環境變數優先，否則解析~/.config/minimax/env。不讀取其他應用的聊天憑證，不把金鑰寫入 skill、命令列或任務記錄。國內/國際站及工具環境見 配置與恢復。 - 缺少金鑰時，用
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，首尾幀由輸入圖片決定比例。四種 H3 模型的解析度、時長和參考比例限制不同，客戶端按模型校驗。
--first-frame、--last-frame各至多一張；多模態參考使用可重複的--ref-image、--ref-video、--ref-audio。首尾幀不能與多模態參考混用。保持素材順序，並在提示詞中明確「參考圖1」「參考影片1」等角色。- 素材支援本機檔案、HTTPS URL、當前官方帳戶的
mm_file://控制代碼。本機輸入先儲存不可變副本並校驗格式、尺寸、時長等；遠端輸入的媒體規格由官方驗證，不聲稱已在本地審看。 - 小型本機素材預設
--delivery inline，按官方 data URI 格式隨生成請求傳入，無需第三方託管。Base64 膨脹後的請求總大小須不超過 64 MB；本機 MOV 或較大素材可顯式使用--delivery r2，然後執行host。不自動上傳、轉碼或修改使用者原檔案來繞過限制。 - R2 模式只使用已配置的私有桶，按雜湊複用物件並驗證匿名下載。上傳前遵守目標專案的素材和隱私約定；僅在當前任務授權的素材範圍內託管。配置或託管失敗時報告，不自動更換圖床。
製作與續查
使用者要求生成影片時完成一條候選；批次和額外嘗試遵循本次約定。每個候選使用新任務目錄，優先放在專案忽略的 tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/；無專案時使用工作區臨時目錄或使用者指定位置，不覆蓋舊任務。
- 用
doctor --check-api檢查配置。將動作、鏡頭、角色/道具約束和聲音要求寫入 UTF-8 提示詞檔案，用prepare凍結提示詞、官方引數、服務區域和輸入副本。此步離線，不生成影片。 - 僅在
--delivery r2且含本機素材時執行host。此操作把素材傳到私有 R2，並讓 MiniMax 使用簽名連結；inline 素材直接傳給 MiniMax。 - 執行一次
submit。客戶端在付費 POST 前獨佔儲存提交記錄和請求雜湊；官方未在所核對文件中承諾冪等鍵，不能把本機請求 UUID 當作服務端去重保證。 - 使用獨立的
status查詢，狀態為queued/running/succeeded/failed/cancelled。用宿主可中斷等待並保持進度溝通，不在長 shell 命令裡輪詢數分鐘。 - 成功後用
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 下載。