跳到主要内容

Python SDK

即将发布

Python SDK 正在开发中，尚未正式发布。可前往 GitHub 关注进度，或 Star 仓库以在发布时收到通知。

计划支持的包​

运行要求： Python ≥ 3.9

包名说明
manycore-aholo-sdk-asset文件上传（单文件/分块上传，支持断点续传）
manycore-aholo-sdk-world3DGS 世界重建与生成
manycore-aholo-sdk-lux3dLux3D 图像/文字转 3D 生成、材质迁移
manycore-aholo-sdk-core公共 HTTP 客户端、鉴权、错误类型、轮询

预计 API 风格​

发布后安装方式：

pip install manycore-aholo-sdk-asset
pip install manycore-aholo-sdk-world
pip install manycore-aholo-sdk-lux3d

代码风格预览（以世界重建为例）：

from manycore.aholo_sdk_asset import create_asset_client
from manycore.aholo_sdk_world import create_world_client

asset = create_asset_client(region='cn')
world = create_world_client(region='cn')

uploaded = asset.upload_file('room.mp4')

result = world.reconstructions.create({
    'name': '客厅',
    'resources': [{'url': uploaded.url, 'type': 'video'}],
    'taskQuality': 'normal',
    'scene': 'model',
    # 'use_mask': False,  # 可选：true 时对上传资源抠图
})

detail = world.wait_for(result['worldId'])
print(detail)

预计任务状态（与 TypeScript / Java SDK 一致）​

World​

进行中：PENDING · PREPROCESSING · RUNNING
成功终态：SUCCEEDED
失败终态：FAILED · CANCELED · TIMEOUT · REJECTED

Lux3D​

0 初始化 · 1 进行中 · 3 成功 · 4 失败

现阶段替代方案​

在 Python SDK 发布之前，可以：

  1. 直接调用 REST API，参考 快速开始 中的 cURL 示例用 requests 或 httpx 封装
  2. 使用 TypeScript 或 Java SDK 作为服务端中转

GitHub​

GitHub README 仅作安装说明。若与本文冲突，以本文为准。源码与可运行示例见 GitHub。