跳到主要内容

API 与集成

SuperSplat API 可发布到 superspl.at，并检查已认证用户拥有的场景，将采集、训练、转换或内部工作流直接连接到平台。

上传后出现在管理页，可编辑、在 Studio 打开，或通过场景页分享。

完整 API 参考

端点、请求结构和响应示例见 API 参考。

适用情况​

可用于：

  • 不打开编辑器发布。
  • 为采集或重建应用添加发布。
  • 批量上传训练或转换结果。
  • 列举或检查用户场景。
  • 网络中断后续传大型文件。

认证​

全部操作需 PlayCanvas 访问令牌。按 REST API 授权创建，在 Authorization 头发送：

Authorization: Bearer YOUR_ACCESS_TOKEN

令牌是机密，不要嵌入公开客户端代码或分享给其他用户。

可恢复上传流程​

分片上传可靠传输大文件：

  1. 以源格式和可选元数据创建会话。
  2. 请求一或多个分片的签名 URL。
  3. 直接上传分片到存储。
  4. 用返回的 ETag 完成上传。

完成后创建场景，转换优化期间可能保持 processing。默认 Unlisted。

客户端集成​

同一 API 同时支持用户集成和自定义自动化：

客户端可通过可选 uploadClient 标识：

{
  "uploadClient": {
    "id": "example-client",
    "version": "1.0.0"
  }
}

uploadClient 表示执行上传的应用，softwareTools 独立记录创建工具。

另请参见​