Aholo API

Appearance

创建 3D 重建项目 ​

从多角度照片重建真实场景的 3D 模型。

基本信息 ​

项目值
方法POST
路径/v2/aholo/project/create-3d-recon
认证API Key
Content-Typeapplication/json

Request ​

Query Param ​

参数必须类型说明
appuid✅string第三方用户 ID

Request Body ​

json
{
  "projectName": "我的房间",
  "cover": "https://cdn.aholo.ai/path/to/cover.jpg",
  "accessLevel": 0,
  "scene": "space",
  "resources": [
    {
      "name": "angle1.jpg",
      "type": 0,
      "url": "https://cdn.aholo.ai/path/to/img1.jpg",
      "meta": { "width": 1920, "height": 1080 }
    },
    {
      "name": "angle2.jpg",
      "type": 0,
      "url": "https://cdn.aholo.ai/path/to/img2.jpg",
      "meta": { "width": 1920, "height": 1080 }
    }
  ]
}

Body 参数说明 ​

参数必须类型说明
projectName✅string项目名称
cover❌string封面图 URL
accessLevel❌int访问级别：0 公开，1 私有
scene✅string场景类型：model 物体，space 室内
resources✅array多角度照片列表

建议

3D 重建建议上传 5-20 张不同角度的照片，覆盖完整场景。

Example ​

bash
curl -X POST 'https://openapi.kujiale.com/v2/aholo/project/create-3d-recon?appuid=user123' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "projectName": "我的房间",
    "scene": "space",
    "resources": [
      {"name": "angle1.jpg", "type": 0, "url": "...", "meta": {"width": 1920, "height": 1080}},
      {"name": "angle2.jpg", "type": 0, "url": "...", "meta": {"width": 1920, "height": 1080}}
    ]
  }'
python
import requests

payload = {
    "projectName": "我的房间",
    "scene": "space",
    "resources": [
        {"name": "angle1.jpg", "type": 0, "url": url1, "meta": {"width": 1920, "height": 1080}},
        {"name": "angle2.jpg", "type": 0, "url": url2, "meta": {"width": 1920, "height": 1080}}
    ]
}

response = requests.post(
    "https://openapi.kujiale.com/v2/aholo/project/create-3d-recon",
    params={"appuid": "user123"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json=payload
)

Response ​

json
{
  "c": "0",
  "d": "PROJECT_ID"
}

场景类型 ​

Scene说明建议
model单个物体拍摄物体各角度
space室内空间拍摄房间全景

下一步 ​

轮询 获取项目信息 查询状态。