获取项目信息

查询项目详情、任务状态和生成的 3D 文件。

基本信息

项目	值
方法	GET
路径	/v2/aholo/project/info
认证	API Key

Request

Query Param

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

Example

curl

curl -X GET 'https://openapi.kujiale.com/v2/aholo/project/info?appuid=user123&projectId=PROJECT_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Python

import requests

url = "https://openapi.kujiale.com/v2/aholo/project/info"
params = {"appuid": "user123", "projectId": project_id}
headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers)
data = response.json()

JavaScript

const response = await fetch(
  `https://openapi.kujiale.com/v2/aholo/project/info?appuid=user123&projectId=${projectId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const data = await response.json();

Response

完成状态（status = 3）

{
  "c": "0",
  "d": {
    "projectId": "3FO4K4WBOFQ4",
    "name": "乐高-猫头鹰",
    "cover": "https://holo-cos.aholo3d.cn/...",
    "projectType": 0,
    "scene": "model",
    "task": {
      "taskId": "3FO4K4WBNNYV",
      "status": 3,
      "result": {
        "plyPath": "https://...point_cloud.ply",
        "spzPath": "https://...point_cloud_compressed.spz",
        "sogPath": "https://...point_cloud.sog"
      }
    },
    "created": 1772638627000,
    "lastModified": 1772640130000
  }
}

处理中状态（status = 1）

{
  "c": "0",
  "d": {
    "projectId": "...",
    "task": {
      "status": 1
    }
  }
}

字段说明

字段	类型	说明
projectId	string	项目 ID
name	string	项目名称
projectType	int	0: 3D重建, 1: 3D生成
scene	string	model 物体, space 室内
task.status	int	任务状态：0-8，详见上方状态枚举
task.result.plyPath	string	PLY 文件 URL
task.result.spzPath	string	SPZ 文件 URL
task.result.sogPath	string	SOG 文件 URL

任务状态

Status	含义	是否终态
0	排队中，任务还未被提交	否
1	结束排队，等待被执行，任务已被提交	否
2	执行中	否
3	成功	是
4	失败	是
5	取消	是
6	超时	是
7	被拒绝	是
8	预处理中	否