快速开始

Aholo API 用于将图片转化为 3D 内容。本指南将帮助你快速完成第一个 3D 项目。

认证方式

所有 API 请求需要在 URL 中携带以下鉴权参数：

参数	必填	说明
appkey	是	平台分配的 appkey
timestamp	是	当前时间戳（毫秒）
sign	是	签名值

签名计算：

sign = md5(appsecret + appkey + timestamp)

详情见 认证方式。

5 分钟入门

Step 1: 获取上传 Token

curl -X GET 'https://openapi.kujiale.com/v2/aholo/upload/token?appkey=YOUR_APPKEY&timestamp=1234567890000&sign=YOUR_SIGN'

返回 ousToken、globalDomain。

Step 2: 上传图片

curl -X POST '{globalDomain}/ous/api/v2/single/upload' \
  -H 'ous-token-v2: {ousToken}' \
  -F 'file=@image.jpg'

Step 3: 创建 3D 项目

curl -X POST 'https://openapi.kujiale.com/v2/aholo/project/create-3d-gen?appkey=YOUR_APPKEY&timestamp=1234567890000&sign=YOUR_SIGN' \
  -H 'Content-Type: application/json' \
  -d '{
    "projectName": "my-3d-model",
    "prompt": "还原该空间",
    "resources": [{"url": "https://.../image.jpg", "type": 0}]
  }'

返回 projectId。

Step 4: 轮询结果

# 查询项目获取 taskId
curl 'https://openapi.kujiale.com/v2/aholo/project/info?projectId=xxx&appkey=YOUR_APPKEY&timestamp=1234567890000&sign=YOUR_SIGN'

# 轮询任务状态
curl 'https://openapi.kujiale.com/v2/aholo/task/status?taskId=xxx&appkey=YOUR_APPKEY&timestamp=1234567890000&sign=YOUR_SIGN'

当 status === 3 时完成，获取 result.plyPath、result.spzPath。

支持的输入

类型	说明
单张图片	室内场景照片效果最佳
多张图片	支持多图重建

输出格式

• .ply - 原始格式
• .spz - 压缩格式（推荐）
• .sog - 超压缩，Web 加载用

下一步

• 完整流程 - 详细的 API 调用流程
• API 参考 - 上传相关接口
• 代码示例 - Python/JS 示例