发行说明
Aholo 开放平台 API、SDK、Skills、MCP 与文档的发布说明。
2026 年 11 月
2026-11-13
域名
- 国内文档站与 API Key 控制台改为
https://labs.aholo.cn。 - 文档和 OpenAPI 示例中的国内网关改为
https://api.aholo.cn。
SDK
- 发布 core 1.4.0、asset 1.4.0、world 1.5.0、Lux3D 1.10.0(TypeScript、Java、Python)。
region=cn默认请求https://api.aholo.cn。
MCP
- 发布
@manycore/aholo-sdk-mcp@1.10.0,依赖@manycore/aholo-sdk-core@^1.4.0、@manycore/aholo-sdk-asset@^1.4.0、@manycore/aholo-sdk-world@^1.5.0、@manycore/aholo-sdk-lux3d@^1.10.0。region=cn默认请求https://api.aholo.cn。
2026 年 10 月
2026-10-13
空间理解
- 新增空间理解 OpenAPI:用室内
.ply创建异步任务,轮询详情并分页查询。路径为POST /spatial-understanding/v1/tasks、GET /spatial-understanding/v1/tasks/{taskId}、POST /spatial-understanding/v1/tasks/list。 - 仅提供 OpenAPI,暂无 SDK、MCP 与 Skill。
SDK
- 发布 core 1.3.0、asset 1.3.0、world 1.4.0、Lux3D 1.9.0(TypeScript、Java、Python)。
Lux3D
- SDK 1.8.0(TypeScript
@manycore/aholo-sdk-lux3d、Javacom.manycoreapis:aholo-sdk-lux3d、Pythonmanycore-aholo-sdk-lux3d)补齐 9 月 24 日已上线的四个接口:部件拆分、关节化与动画、数字人绑骨、动画重定向。
MCP
- 发布
@manycore/aholo-sdk-mcp@1.9.0,依赖@manycore/aholo-sdk-core@^1.3.0、@manycore/aholo-sdk-asset@^1.3.0、@manycore/aholo-sdk-world@^1.4.0、@manycore/aholo-sdk-lux3d@^1.9.0。 - 发布
@manycore/aholo-sdk-mcp@1.8.0(26 个 tools),依赖@manycore/aholo-sdk-lux3d@^1.8.0。 - 新增
lux3d_part_split、lux3d_articulation_animation、lux3d_humanoid_auto_rig、lux3d_humanoid_animation_retarget。
2026 年 9 月
2026-09-24
Lux3D
- 恢复 部件拆分
POST /lux3d/v1/part-split/task/create(8 月 25 日曾移除)。 - 新增 关节化与动画
POST /lux3d/v1/articulation-animation/task/create:glbUrl与prompt均必填。 - 新增 数字人自动绑骨
POST /lux3d/v1/animations/rig/task/create。 - 新增 数字人动画重定向
POST /lux3d/v1/animations/retarget/task/create:animationIds为 1–10 个预设动作,可逐动作或合并输出,格式为 GLB 或 FBX。
2026-09-17
渲染云
- Mesh 上传解析
POST /rendercloud/v1/mesh-upload-process/task/create新增可选fastUpload,默认false。为true且文件为 GLB 时走快速上传;未传或为false时走普通上传。
2026-09-10
渲染云
- OpenUSD 实时渲染补充 灯光(
RectLight/SphereLight)和 环境光(manycore:environment:giIntensity);增量 Patch 支持相机、Mesh / 3DGS 模型、灯光和环境光的更新、新增与删除。 - 创建实时会话
POST /rendercloud/v1/streams新增可选settings.autoEnhanceAI。云端渲染固定 1 单位 = 1 毫米、Z-up。详见 API → 渲染云。
Lux3D
- 新增多模态生图接口
POST /lux3d/v1/generate/multimodal-to-image/task/create:img与prompt至少一个。 - 四视图改为多模态:路径仍为
POST /lux3d/v1/generate/image-to-four-view/task/create,img/prompt至少一个。 - 多格式导出
outputFormat新增stl、3mf(GLB 本身不能通过outputFormat请求)。 - 图生/文生 3D 仅支持
G1/G1-Turbo;version可省略(使用默认版本),建议显式传入。 - 任务列表筛选
status仅支持0/1/3/4;结果中仍可能出现已取消6。
SDK
- 发布 Lux3D SDK 1.7.0:TypeScript
@manycore/aholo-sdk-lux3d、Javacom.manycoreapis:aholo-sdk-lux3d、Pythonmanycore-aholo-sdk-lux3d。 - 三种语言均新增
multimodalToImage/multimodal_to_image(含本地文件 helper),四视图支持prompt,导出支持stl/3mf,任务列表筛选不再接受6。
MCP
- 发布
@manycore/aholo-sdk-mcp@1.7.0(22 个 tools),依赖@manycore/aholo-sdk-lux3d@^1.7.0。 - 新增
lux3d_multimodal_to_image;lux3d_image_to_four_view支持prompt/localPath;多格式导出增加stl/3mf;lux3d_list_tasks筛选去掉6。
2026 年 8 月
2026-08-25
Lux3D
- 新增单图生四视图接口
POST /lux3d/v1/generate/image-to-four-view/task/create和多格式导出接口POST /lux3d/v1/multi-format-export/task/create。 - 图生/文生 3D 的
version改为必填,仅支持G1/G1-Turbo;faceCount范围调整为 10000–300000,新增aiPredictSize,移除textureSize。 - 材质迁移的
version必填且固定为v3.0-standard,新增aiPredictSize/customSize;任务详情新增bizId,状态新增6(已取消)。 - **破坏性变更:**移除 GLB 模型拆件接口。
SDK
- 发布 Lux3D SDK 1.6.0:TypeScript
@manycore/aholo-sdk-lux3d、Javacom.manycoreapis:aholo-sdk-lux3d、Pythonmanycore-aholo-sdk-lux3d。 - 三种语言均新增四视图与多格式导出资源,更新图生/文生、材质迁移、任务查询与轮询,并移除拆件资源。
MCP
- 发布
@manycore/aholo-sdk-mcp@1.6.0(21 个 tools),依赖@manycore/aholo-sdk-lux3d@^1.6.0。 - 新增
lux3d_image_to_four_view、lux3d_material_transfer、lux3d_multi_format_export,移除lux3d_part_split,并同步新参数与取消状态。
2026-08-18
Lux3D
- 新增 GLB 模型拆件接口:
POST /lux3d/v1/part-split/task/create。 - 新增 任务历史分页接口:
GET /lux3d/v1/generate/task/list,支持页码、状态与 Unix 毫秒时间范围筛选。 - G1 的
textureSize默认值由 1000 调整为 2048。
SDK
- 发布 Lux3D SDK 1.5.0:TypeScript
@manycore/aholo-sdk-lux3d、Javacom.manycoreapis:aholo-sdk-lux3d、Pythonmanycore-aholo-sdk-lux3d。 - 三种语言均新增 GLB 拆件与任务列表 API、类型、示例和测试。
MCP
- 发布
@manycore/aholo-sdk-mcp@1.5.0(19 个 tools),新增lux3d_part_split与lux3d_list_tasks,依赖@manycore/aholo-sdk-lux3d@^1.5.0。
2026 年 7 月
2026-07-23
Lux3D
- Lux3D OpenAPI 新增版本
G1(beta):支持多视角输入imgs(1–32)、enablePbr/textureSize;产物为 zip / glb / ply。 - 破坏性变更:移除请求字段
needUsdz/needObj/needFbx,统一改为outputFormat(字符串数组)。 - v2.0-preview 与 v3.0-standard 对齐为五格式输出槽位;v1.0-pro 改为返回单个 ZIP(不再使用
.lux3d后缀描述)。 faceCount对 v2.0-preview / v3.0-standard / G1 生效。详见 API → Lux3D。
SDK
- 发布 TypeScript
@manycore/aholo-sdk-lux3d@1.4.0、Javaaholo-sdk-lux3d@1.4.0、Pythonmanycore-aholo-sdk-lux3d@1.4.0,对齐上述 OpenAPI(G1、outputFormat、多视角 helpers)。详见 SDK 概览 与各语言文档。
MCP
- 发布 npm 包
@manycore/aholo-sdk-mcp@1.4.0;Lux3D tools 支持G1、outputFormat、enablePbr/textureSize,以及imgs/localPaths多视角;依赖@manycore/aholo-sdk-lux3d@^1.4.0。详见 MCP。
2026-07-08
Lux3D
- Lux3D OpenAPI 默认版本升级为
v3.0-standard;新增faceCount、needUsdz/needObj/needFbx请求字段。 - v3.0 成功时返回五格式输出(
outputs[0..4]:zip / glb / usdz / obj zip / fbx zip);未请求的可选格式返回NOT_REQUESTED。 - 创建任务新增并发限制错误码
GENERATION_CONCURRENCY_LIMIT_EXCEEDED。详见 API → Lux3D。
SDK
- 发布 TypeScript
@manycore/aholo-sdk-lux3d@1.3.0、Javaaholo-sdk-lux3d@1.3.0、Pythonmanycore-aholo-sdk-lux3d@1.3.0,对齐 Lux3D OpenAPI v3.0(默认v3.0-standard、faceCount、可选导出格式)。详见 SDK 概览 与各语言文档。
MCP
- 发布 npm 包
@manycore/aholo-sdk-mcp@1.2.0;Lux3D tools 支持v3.0-standard、faceCount与needUsdz/needObj/needFbx;依赖@manycore/aholo-sdk-lux3d@^1.3.0。详见 MCP。
2026-07-07
SDK
- 首发 Python SDK 至 PyPI:
manycore-aholo-sdk-core/manycore-aholo-sdk-asset/manycore-aholo-sdk-lux3dv1.2.0,manycore-aholo-sdk-worldv1.3.0(支持 Insta360insv重建);与 TypeScript / Java SDK 能力对齐。详见 Python SDK 与 SDK 概览。
2026 年 6 月
2026-06-29
World
- 世界重建 OpenAPI 补充 资源格式 与
type=insv(Insta360 全景.insv);URL 扩展名须与type一致(image:.jpg/.jpeg/.png/.webp;video:.mp4/.mov)。 - 世界生成明确 仅支持图片 输入(至多 1 张,同上 image 扩展名);请求体
resources使用GenerateWorldResourceItem。
SDK
- 发布 TypeScript
@manycore/aholo-sdk-world@1.3.0、Javaaholo-sdk-world@1.3.0,对齐上述 World OpenAPI:重建type支持insv,类型导出WorldResourceItem/WorldResourceType;生成使用GenerateWorldResourceItem(仅image)。Asset、Lux3D、core 仍为 v1.2.0。详见 SDK 概览。
MCP
- 发布 npm 包
@manycore/aholo-sdk-mcp@1.1.0,供 Cursor、Claude Desktop 等本地 Agent 通过 stdio MCP 调用 Aholo 上传、世界重建、Lux3D 等能力(17 个 tools);依赖@manycore/aholo-sdk-world@^1.3.0,支持 Insta360insv重建。 - 文档站新增 MCP 指南,含安装、
mcp.json配置及 MCP / Skill / SDK 选型说明;快速开始 与 SDK 文档已对齐 OpenAPI 资源格式。
2026-06-16
World
- 创建重建任务(
POST /world/v1/reconstructions)新增可选参数useMask,用于控制是否对上传资源抠图。 - 查询世界详情(
GET /world/v1/{worldId}):AI 生成世界成功后可返回assets.imagery.panoUrl(全景图);assets结构新增imagery,LOD 元数据统一在assets.splats.urls.lodMetaPath。 assets.semanticsMetadata补充upAxis字段(Y/Z),标明世界坐标 up 轴。详见 API → 世界。
SDK
- 发布 TypeScript、Java SDK v1.2.0,对齐上述 World 接口变更。详见 SDK 概览。
2026-06-09
SDK
- 发布 TypeScript、Java SDK v1.1.0(Asset / World / Lux3D)。详见 SDK 概览。
- Python SDK 尚未发布。
2026-06-03
SDK
- 首发 TypeScript、Java SDK v1.0.0。详见 SDK 概览。