Autodesk Reality Capture API报错误码22(Data is not ready) 如何解决？

• 确认任务是否真正完成
  错误码22明确表示数据未生成完毕，不要急于调用下载接口。必须通过GET /jobs/{jobId}接口轮询任务状态，只有当状态显示为success时，再发起下载请求，不要依赖固定等待时长，以接口返回的状态为准。

• 排查输入图片的合规性
  换多组图片仍报错，可能这些图片存在共性问题：

  • 数量不达标：至少需要10张照片，且相邻照片间的场景重叠度要达到60%以上
  • 格式不支持：仅接受JPG、PNG、TIFF格式，避免使用RAW等未压缩格式
  • 质量不合格：模糊、过度曝光/欠曝光的图片会导致处理失败，需确保每张图片清晰、曝光正常

• 核对任务创建参数
  调用POST /jobs创建任务时，参数配置不能出错：

  • type字段必须设置为photoscene（对应照片转3D场景的任务类型）
  • outputFormat要包含你需要下载的格式（如obj、fbx等），未指定的格式不会生成下载资源
  • 输入文件的OSS路径或上传后的文件ID要准确，避免拼写错误

• 检查API权限令牌有效性
  请求头中的Authorization令牌过期或权限不足，会导致后台任务处理失败，进而无法生成可用数据。可以重新获取有效令牌后重试任务。

• 查看任务日志定位具体问题
  调用GET /jobs/{jobId}/logs接口获取任务处理日志，日志会详细记录过程中的错误（比如图片匹配失败、特征点数量不足等），根据提示针对性调整输入图片或参数。

内容的提问来源于stack exchange，提问作者vikvik1