项目 API
项目是 Aholo 的核心概念。创建项目后,系统会生成 3D 模型文件。
接口列表
| 接口 | 方法 | 说明 |
|---|---|---|
| 创建 3D 生成项目 | POST | 从文本/图片生成 3D |
| 创建 3D 重建项目 | POST | 从多角度照片重建 3D |
| 获取项目信息 | GET | 查询项目详情和结果 |
| 批量查询任务 | GET | 批量查询多个项目状态 |
项目类型
| 类型 | 说明 | 输入 |
|---|---|---|
| 3D 生成 | AI 生成 3D 内容 | 文本提示词 + 图片 |
| 3D 重建 | 照片重建 3D 模型 | 多角度照片 |
任务状态
| Status | 含义 |
|---|---|
| 1 | 处理中 |
| 2 | 部分完成 |
| 3 | 完成 ✅ |
| 4 | 失败 |
输出格式
项目完成后提供以下 3D 文件格式:
| 格式 | 说明 | 推荐场景 |
|---|---|---|
.ply | 标准 3DGS 格式 | 通用、文件较大 |
.spz | 压缩格式 | Web 展示、体积小 |
.sog | 超压缩格式 | Web 运行时推荐 |
推荐
使用 .spz 或 .sog 格式,体积比 .ply 小 5-10 倍。