查看 HolyCrab 任务并下载结果

任务 ID 是每次生成任务的唯一编号。请妥善保存,以便在 Codex 重启或网络中断后继续查询同一个任务。

通过 Codex 操作

1. 查看最近任务

说:“用 HolyCrab 列出我最近的视频任务,最新的放前面。”也可以提供开始日期、结束日期和类型;开始与结束日期必须一起用。

2. 等待一个任务

说:“继续查询 HolyCrab 任务 TASK_ID,直到完成,不要创建新任务。”请将 TASK_ID 替换为需要查询的任务编号。

3. 下载结果

告诉 Codex 把结果下载到指定文件夹。图片任务返回多张时,明确要求全部保存;视频和返回的所有音频文件也可以下载。覆盖已有文件前仍需确认。

确认后发生网络中断

  • 先查看最近任务和本机提交记录(CLI 命令中称为 attempt)。
  • 已有任务 ID 时,继续等待该任务。
  • 结果为 unknown 或列表中暂时未找到记录,均不能证明线上没有创建;请勿再次提交同一个付费请求。
  • 仅当你确定需要生成新的结果并再次同意费用时,才创建新任务。

继续查看样片或正片

  • 分别保留样片和正片的任务 ID。样片完成只代表预览视频完成,1080p 或 4K 正片是另一个任务。
  • 转正片前,让 Codex 查询是否已有正片和样片有效期。正片正在生成或已成功且分辨率与请求相同时,继续查询该任务;分辨率不同或不明确时停止转换并保留原任务,每个样片只对应一个正片;样片过期不会阻止继续查询已有正片。
  • 已有正片失败时,先查看原因。只有样片仍有效、服务也允许转正片时,才重新报价并确认新的任务,不自动重发。
  • 没有可继续使用的正片,而样片已过期或不可用时,按返回原因处理。重新做样片仍需单独报价和确认。

使用终端操作(可选)

查看可选的任务命令
holycrab tasks list
holycrab tasks list --start-date 2026-09-01 --end-date 2026-09-14 --type VIDEO
holycrab tasks get TASK_ID
holycrab tasks wait TASK_ID --timeout 600
holycrab download TASK_ID --output ./holycrab-result.mp4
holycrab generate attempts list
holycrab generate attempts get ATTEMPT_ID

未成功时

  • wait 超时不代表任务失败,稍后继续等待同一个 ID。
  • 任务失败先看公开错误,再修改请求。
  • 下载提示文件已存在时,换目录或文件名;只有你明确决定后才覆盖。