用 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,先查询,再决定。