Aholo 3DGS reconstruction and generation
通过自然语言调用云端3DGS重建与生成API
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Aholo 3DGS reconstruction and generation。 它的用途是：通过自然语言调用云端3DGS重建与生成API 完整的 Skill 内容见：https://321skill.com/skills/aholo-3dgs-reconstruction-and-generation/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'将这段无人机拍摄的视频重建为3D场景，场景类型为space，质量选high，并使用mask。' AI会先确认mask仅在model场景下生效（space场景下忽略），然后自动调用Aholo API上传视频、创建重建任务，最后返回worldId和在线查看链接。如果用户说'生成一个未来城市的3D模型'，AI会明确询问是2D渲染还是3D任务，确认后调用生成接口。
介绍
这个Skill解决了在AI开发环境中直接进行3D高斯泼溅（3DGS）重建与生成的问题。实际工作中，开发者或内容创作者经常需要将视频或图片转换为可交互的3D模型，但传统的3D重建工具往往需要本地GPU、复杂的命令行操作和漫长的等待。通过Aholo的OpenAPI，这个Skill将整个过程简化为一句自然语言指令，自动完成上传、创建任务、轮询状态、获取结果（PLY/SPZ/SOG）等步骤，让3D任务像调用AI对话一样简单。
使用方式很简单，你只需要在AI助手中正确设置环境变量AHOLO_API_KEY，然后通过自然语言描述你的需求即可。例如，你可以说“将这段视频重建为3D模型，场景类型为model，质量high”，AI会自动调用上传接口获取上传令牌，上传文件，然后调用/global/world/v1/create创建重建任务，返回worldId。之后你可以通过“查看任务状态”来轮询进度，最终获得可在线查看的3D模型链接（https://studio.aholo3d.com/3dgs-model/{worldId}）。整个过程无需手动编写API请求代码，AI代理会替你完成所有HTTP交互。
它非常适合需要频繁处理3D内容的团队或个人。尤其是那些已经使用AI编码助手（如Claude、Cursor）进行开发，但希望在不离开对话环境的前提下完成3D资产制作的用户。例如，游戏开发者可以快速生成道具模型，电商运营可以制作商品3D展示，内容创作者可以将实景视频转换为可交互的3D场景。此外，对于需要批量处理多个视频（如一个视频生成一个3DGS）的场景，这个Skill也支持通过明确指令分别创建。
建议在第一次使用前先到Aholo官网（labs.aholo3d.com）获取API Key，并确保账户有足够积分。需要注意的是，这个Skill只处理3D任务（重建/生成），如果用户意图是2D渲染，AI会先澄清意图，避免误调用。另外，对于重建任务，AI会强制要求用户确认scene（model/space）和taskQuality（low/normal/high）以及是否使用useMask（仅model场景有效），不会替用户做默认选择，确保每次创建都符合用户预期。
常见问题
如何获取Aholo API Key？
前往 https://labs.aholo3d.com/api-keys 创建，设置环境变量 AHOLO_API_KEY 即可。
支持哪些输入格式？上传视频还是图片？
支持视频和图片文件夹；上传时使用 `imageDir` 指代所有图片，使用 `videoPaths` 指代视频文件；具体格式需参考Aholo官方文档。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/aholo-3dgs-reconstruction-and-generation/raw/index.md 读取 Aholo 3DGS reconstruction and generation 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/aholo-3dgs-reconstruction-and-generation/raw/index.md（查看排版版本）