为什么我的 Hyper3D 生成任务失败了

Hyper3D 生成任务可能在任务被接受之前、处理过程中或客户端获取结果时失败。这些阶段的失败原因和积分处理方式各不相同。重试前,请保存完整的错误信息和任务标识符。

常见原因

  • 图片或 3D 输入文件已损坏、格式不受支持、大部分区域透明、尺寸过小,或主体不清晰。
  • 提示词或上传内容无法根据当前内容或安全规则进行处理。
  • API 参数、文件 URL、格式或选项组合不适用于所选端点。
  • 所选钱包的可用积分不足、没有模型访问权限,或缺少所需的订阅权限。
  • 临时性的服务、上传、网络或队列问题导致处理中断。

排查方法

  1. 阅读完整的错误信息,不要反复提交相同的请求。
  2. 对于图片,请确保主体清晰、格式受支持、URL 稳定且前景不透明。对于文本,请简化相互冲突的指令。
  3. 对于 API 调用,请核对端点当前的参数名称和允许值,然后轮询返回的任务 UUID,直至任务达到终止状态,不要将初期的等待状态视为失败。
  4. 检查使用的是正确的个人或团队钱包,确认其可用积分、冻结积分以及历史记录。
  5. 仅当错误看起来是临时性问题时,稍等片刻后重试一次。

积分与失败任务

在网页端,Hyper3D 在支持的工作流程中采用结果确认机制:预览或重新生成可能免费,确认结果时会扣除积分,未使用的冻结积分会在显示的计时结束后释放。对于 API 任务,请查看响应中的 consumed 值和钱包记录;公开文档并未承诺所有最终失败的任务都会有统一的退款结果。

何时联系支持团队

如果相同的有效输入反复失败,或者任务最终失败后出现了意外扣费,请通过反馈渠道或 hello@help.hyper3d.ai 联系支持团队。请提供任务 UUID(或资源链接)、端点或模型、请求时间、最终状态、完整的错误信息、钱包类型、积分记录以及可安全分享的输入样本。请勿发送 API 密钥、密码或私人支付信息。