Reality Capture API报错：指定Photoscene ID不存在问题咨询

可能的原因及对应解决方案 #

1. Photoscene ID输入错误 #

• 直接复制创建接口返回的完整ID，避免手动输入，检查是否包含多余空格、换行符或大小写不一致（Autodesk的ID通常区分大小写）。
• 可将返回的ID复制到文本编辑器中，去除首尾空白后再使用。

2. Photoscene未完成初始化 #

• 创建场景后，接口可能异步完成初始化，并非立即可用。调用GET /photo-to-3d/v1/photoscene/{photosceneId}接口验证状态：
  • 若状态为pending，等待几分钟后重试；
  • 若状态为failed，说明场景创建失败，检查创建请求的参数（如场景名称、设置）后重新创建。

3. 环境不匹配 #

• 创建场景和上传文件必须使用同一环境的API端点，禁止混用测试（sandbox）和生产环境，两个环境的数据库相互独立，跨环境的ID无法识别。

4. 访问令牌问题 #

• 确保上传文件使用的令牌与创建场景的令牌属于同一应用，且包含data:write权限（必要时需包含bucket:create权限）。
• 验证令牌有效性：调用GET /userprofile/v1/users/@me接口，若返回用户信息则令牌有效，否则重新生成令牌。

5. 请求格式错误 #

• 上传文件必须使用multipart/form-data格式，将photosceneId作为表单字段，文件作为file字段提交。示例curl请求：

curl -X POST \
  https://developer.api.autodesk.com/photo-to-3d/v1/file \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: multipart/form-data' \
  -F 'photosceneId=VALID_PHOTOSCENE_ID' \
  -F 'file=@/local/path/to/your/image.jpg'

• 避免将photosceneId放在URL参数中，或使用错误的Content-Type（如application/json）。

6. 场景创建隐性失败 #

• 若创建接口返回了ID但实际不存在，可能是创建过程中存在隐性错误（如参数不合法）。检查创建请求的返回响应，是否包含警告或错误字段，修正参数后重新创建场景。

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