Aholo World
供 Cursor、OpenClaw 等 AI 助手使用的 3DGS 世界重建与世界生成 Skill。助手会按国内站 World Open API 帮你完成：上传素材、创建任务、轮询 worldId、解读 assets 产物等。
| 项目 | 说明 |
|---|---|
| 技能 ID | aholo-3dgs-reconstruction |
| 适用网关 | https://api.aholo3d.cn（世界 /world/v1/...；上传凭证 /asset/v1/...） |
| SkillHub | skillhub.cn/skills/aholo-3dgs-reconstruction |
| 接口规范 | 本站 快速开始、API |
能帮你做什么
- 世界重建：多图（≥20 张）或视频 → 3DGS 世界
- 世界生成：文案、单图或图文组合 → 3D 空间
- 任务跟进：轮询状态，任务成功后获取 PLY / SPZ 等下载地址
典型对话：「用某文件夹里的照片做空间重建，质量选 high」——助手会引导确认 scene、taskQuality，再代你调用 API（详见 SkillHub 上的 SKILL.md）。
安装
任选一种方式；安装步骤与版本以 SkillHub 技能页 为准。
| 方式 | 适合谁 | 怎么做 |
|---|---|---|
| CLI（推荐） | 本机已用终端 | 安装 SkillHub CLI 后执行 skillhub install aholo-3dgs-reconstruction |
| 对话安装 | 希望助手代装 | 在 SkillHub 页复制「对话安装」提示词发给 Cursor 等 |
| Zip | 离线或手动管理目录 | 下载压缩包，将 skill 目录放入 Agent 的 skills 路径 |
CLI 一键安装 SkillHub（含推荐源）：
curl -fsSL https://skillhub.cn/install/install.sh | bash
skillhub install aholo-3dgs-reconstruction
安装后若使用 OpenClaw 等 Agent，建议重启一次。仅装 CLI、不装预置技能时，在 install 命令后加 -s -- --no-skills，详见 SkillHub 文档。
使用前准备
- 在 labs.aholo3d.cn/api-keys 申请 API key，配置到运行环境（如
AHOLO_API_KEY）。 - 请求头：
Authorization: <API key>，无需Bearer前缀——见 授权。 - 首次手写 API 可先走 快速开始；Skill 内的参数约束、单次创建、轮询策略以 SKILL.md 为准。
会调用哪些接口
| 用途 | 接口 |
|---|---|
| 获取上传凭证 | GET /asset/v1/token |
| 创建重建 | POST /world/v1/reconstructions |
| 创建生成 | POST /world/v1/generations |
| 查询状态与产物 | GET /world/v1/{worldId} |
字段、枚举与错误结构以本站 API 为准。