Agent Skills
返回列表
Aholo 3DGS 重建与生成

Aholo 3DGS 重建与生成

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a0383623/aholo-3dgs-reconstruction。

技能介绍

解决什么问题

当用户说「按视频/图片生成 3D」时,真正要做的不是 2D 出图,而是调用 Aholo 开放平台创建 3DGS 重建或生成任务、跟踪 worldId 并拿到可预览/可下载的模型文件。这个技能把 2D/3D 歧义、参数确认、上传、创建、轮询和排错收敛到同一条 Agent 可执行流程里。

技能如何工作

  • 适用边界:只处理 3D reconstruction、generation,以及查询 worldId、获取 PLY、SPZ 等产物;2D 文生图不适用。
  • 执行方式:默认由 Agent 代跑 aholo_reconstruct.py,需要配置 AHOLO_API_KEY;流程包括获取上传 token、上传素材、调用 /world/v1/*、记录 worldId。
  • 重建确认:创建前需一轮内确认 scene、taskQuality 和 useMask;useMask 仅在 scene=model 时生效,避免默认替用户下单。
  • 成本控制:同一意图默认最多一次 create;多个视频必须先让用户选择合并为一个 3DGS 或每个视频单独建,避免重复扣费。
  • 结果跟进:创建后先询问是否等待,再决定同步 poll 或返回 worldId 与 Studio 链接;失败时按 bizCode 判断未登录、积分不足等问题。

适用边界与注意

这个技能面向明确的 3D 任务,不适合「生成一张效果图」这类请求。若素材是图片目录,必须整体上传;若网络使用自签证书,应优先配置 CA 证书,而不是默认关闭 TLS 校验。

使用场景

  • 需要把房间拍摄视频转成可在线预览的 3DGS 模型时,创建 Aholo 重建任务并拿到 worldId 链接。
  • 拿到 20 张以上商品多角度照片后,希望上传整个图片目录生成物体级 3D 模型并查询产物路径。
  • 同时有 2-3 段产品视频,需要先确认合并为一个 3DGS 或各自单独重建,再按用户选择创建任务。
  • 已有 worldId 后,需要同步轮询任务终态,并在成功后读取 PLY 或 SPZ 文件路径。

适合人员

  • 需要把拍摄视频转成可交付 3D 资产的产品工程师。
  • 需要在 Agent 中调用第三方 3D 开放接口的全栈工程师。
  • 负责 3D 内容流水线、需要轮询任务和产物路径的资产工程师。
  • 需要区分 2D/3D 意图并控制 API 扣费风险的智能体应用开发者。