DEVELOPER API

API 概览

了解 MeshBuilder 3D REST API 的地址、请求格式、任务状态和错误处理。

最后更新: 2026-08-20

MeshBuilder 3D 提供 REST API，用于账户、资产和异步创作任务。完整字段与可在线调试的接口定义请以 Swagger 为准。

基础地址

https://meshbuilder3d.com/api/v1

请求格式

JSON 请求应发送 Content-Type: application/json。需要登录的接口使用当前会话或服务端定义的认证方式；不要把凭据写入前端代码或公开仓库。

curl https://meshbuilder3d.com/api/v1/user/me \
  --header "Accept: application/json"

异步任务

生成、拓扑、UV 与纹理接口不会在一次请求中直接返回最终模型。客户端应保存任务 ID，并按合理间隔查询状态。

错误处理

• 先检查 HTTP 状态码，再解析业务响应。
• 对参数错误直接提示用户修改输入，不要自动重试。
• 对临时网络错误使用有限次数的指数退避。
• 记录请求 ID、任务 ID 和错误信息，避免记录凭据或完整图片数据。

接口定义

接口字段会随服务版本更新。请使用 Swagger UI 查看当前部署版本，或下载 OpenAPI JSON 生成客户端。