• 繁體中文(香港)
  • 用 Codex 上載本機素材

    向 Codex 提供需要使用的檔案路徑。HolyCrab 會先在本機檢查,並在開始上載前展示完整清單。

    讓 Codex 上載

    1. 向 Codex 提供檔案路徑

    請替換為自己檔案的實際絕對路徑,示例中的 Demo/demo 是用戶名稱稱佔位符。

    Windows: C:\Users\Demo\Pictures\front.jpg 和 C:\Users\Demo\Videos\motion.mp4。

    macOS: /Users/demo/Pictures/front.jpg 和 /Users/demo/Movies/motion.mp4。

    Linux: /home/demo/Pictures/front.jpg 和 /home/demo/Videos/motion.mp4。

    向 Codex 說明:“用 HolyCrab 準備上載這兩個參考素材:[圖片路徑] 和 [影片路徑]。先顯示完整清單,我確認後再上載。”

    2. 核對預覽

    逐個檢查目標、實際路徑、檔案名、類型、大小和已知時長。選擇具體檔案,不要選擇資料夾;格式不支援時,按提示更換檔案。

    3. 只確認一次

    確認全部信息正確後,再批准整批上載;如有任何錯誤,請取消並讓 Codex 重新準備清單。

    4. 不要再改檔案

    正式執行前會再次核對。預覽後替換或編輯過的檔案不會上載。

    5. 等待素材處理

    保留返回的素材 ID,讓 Codex 按目標模型檢查。該模型確實需要等待處理時,繼續查詢同一批 ID,不要重複上載。

    批量上載中斷後的結果

    結果含義下一步
    uploaded這些檔案已經取得素材 ID。按目標模型檢查這些 ID。
    failed 或 unknown某個檔案失敗,或連線結果不明確。保留 ID 和提示,完成查詢前不要重新上載。
    not attempted後面的檔案按安全規則沒有開始。解決第一個問題後,只為仍需要的檔案重新準備。

    按要使用的模型檢查素材

    • 拿到素材 ID 表示上載已登記,不代表每個模型都能使用這個檔案。請告訴 Codex 準備用哪個模型生成。
    • Seedance 仍要求素材審核通過;審核中繼續查詢同一素材 ID,審核失敗先按原因處理。Kling、MiniMax 不必等這項審核通過,即使顯示審核中或審核失敗,也先按目標模型做生成預估。
    • 正在刪除的素材,所有模型都不能使用。請換用另一份已有素材。
    • 檔案大小、時長和參考數量限制因模型而異。預估提示檔案信息仍在處理時,繼續等待同一個素材 ID;明確失敗時,按具體原因修改或替換檔案。

    使用終端機上載(可選)

    查看可選的上載命令

    交互命令會先展示檔案預覽,再請求確認。把 ASSET_ID 換成返回的素材 ID,並使用實際模型名;下面以 Kling 4.0 為例。

    macOS / Linux

    holycrab assets upload /absolute/path/front.jpg /absolute/path/motion.mp4

    Windows PowerShell

    holycrab assets upload "C:\Users\Demo\Pictures\front.jpg" "C:\Users\Demo\Videos\motion.mp4"
    holycrab assets get ASSET_ID --model kling-4.0
    holycrab assets wait ASSET_ID --model kling-4.0 --timeout 600

    未成功時

    • 本機檢查失敗時,修復或替換被指出的檔案;這一批沒有檔案被上載。
    • 素材被拒絕時,先確認是哪個模型、具體甚麼原因,再決定修改檔案或重新上載。
    • 結果不明確時保留素材 ID,先查詢,再決定。