Live generation实时生成

Every Aholo World and Lux3D method is one click away in the studio. The left dock sends jobs through Holorra's server routes to the official SDKs, shows a receipt for each call, and follows Lux3D jobs until their result can drop into the scene.Aholo World 与 Lux3D 的每个方法,在创作台里都是一键调用。左侧面板经由 Holorra 的服务端接口把任务交给官方 SDK,每次调用都会显示一条调用回执,并持续跟踪 Lux3D 任务,直到结果可以投放到场景中。

Keys and regions密钥与区域

A live job needs an Aholo API key from labs.aholo.ai (or labs.aholo.cn). There are two ways to provide one:运行实时任务需要 Aholo API 密钥,可在 labs.aholo.ai(或 labs.aholo.cn)申请。提供密钥有两种方式:

  • Server: set AHOLO_API_KEY (and optionally AHOLO_REGION=cn) in the environment.服务端:在环境变量中设置 AHOLO_API_KEY(可选再设置 AHOLO_REGION=cn)。
  • Bring your own: paste a key under API key in the studio header and pick COM or CN. It is kept in your browser's local storage and sent per request as x-aholo-api-key and x-aholo-region. A header key takes precedence over the server key, so jobs run on your own credits.自带密钥:在创作台顶栏的 API 密钥 处粘贴密钥,并选择 COM 或 CN。密钥保存在浏览器的本地存储中,每次请求通过 x-aholo-api-key 和 x-aholo-region 发送。请求头里的密钥优先于服务端密钥,因此任务消耗的是你自己的额度。

Without any key, nothing is sent to Aholo. Requests return a labelled preview instead (see the last section).没有任何密钥时,不会向 Aholo 发送任何内容,请求会返回带标注的预览结果(见最后一节)。

World: SpatialGen and Aholo Reality世界:SpatialGen 与 Aholo Reality

In the World tab在世界标签页SDK callSDK 调用Inputs输入
Generate a world生成世界world.generations.createA prompt, an image URL, or both提示词、图片 URL,或两者同时提供
Reconstruct a space or object重建空间或物体world.reconstructions.createMedia URLs: video, 20+ photos or Insta360 .insv; scene model or space; quality low, normal or high; optional mask媒体 URL:视频、20 张以上照片或 Insta360 .insv;scene 取 model 或 space;质量取 low、normal 或 high;可选主体遮罩(mask)

The World tab takes media by URL. To start from local files, use the MCP server's upload_asset or world_reconstruct_*_from_files tools (see MCP & co-director). Worlds take minutes: our coffee bar took 625 s. A finished world returns splat files; that is how world 05 joined the studio's presets. Your recent worlds are listed by GET /api/aholo/world.世界标签页通过 URL 接收媒体。如果要从本地文件开始,请使用 MCP 服务器的 upload_asset 或 world_reconstruct_*_from_files 工具(见 MCP 与 AI 副导演)。生成一个世界需要几分钟,我们的咖啡吧用了 625 s。完成的世界会返回 3DGS 文件,世界 05 就是这样加入创作台预设的。GET /api/aholo/world 会列出你最近的世界。

The 360° panorama SpatialGen returned for the coffee bar
The panorama SpatialGen returned alongside the coffee bar's splats (world 3FO4K4V99KMD).SpatialGen 随咖啡吧的高斯点一同返回的全景图(世界 3FO4K4V99KMD)。

Lux3D: all ten methodsLux3D:全部十个方法

Method方法What it does作用
textTo3dText to a textured mesh, engine G1 or G1-Turbo由文本生成带纹理的网格,引擎可选 G1 或 G1-Turbo
imgTo3dOne or more images to a mesh; 10k to 300k faces, PBR maps optional由一张或多张图片生成网格;面数 10k 至 300k,PBR 贴图可选
imageToFourViewAn orthographic four-view sheet from an image or prompt由图片或提示词生成正交四视图
multimodalToImageConcept art from a prompt and/or image由提示词和/或图片生成概念图
partSplitA GLB split into semantic parts把 GLB 拆分为语义部件
articulationAnimationJoints and motion from a sentence, returned as URDF用一句话生成关节与运动,以 URDF 格式返回
humanoidAutoRigSkeleton and skin weights on a static humanoid为静态人形模型生成骨骼与蒙皮权重
humanoidAnimationRetarget1 to 10 official clips onto a rigged humanoid把 1 至 10 个官方动作片段重定向到已绑骨的人形模型上
materialTransferA new PBR texture set from a reference image (v3.0-standard)根据参考图生成一套新的 PBR 贴图(v3.0-standard)
multiFormatExportusdz, fbx_zip, obj_zip, stl, 3mfusdz、fbx_zip、obj_zip、stl、3mf

Task status codes follow the SDK: 0 initialising, 1 running, 3 succeeded, 4 failed, 6 cancelled.任务状态码与 SDK 一致:0 初始化,1 进行中,3 成功,4 失败,6 已取消。

Drop-in: the result lands in your world投放到场景:结果直接落进你的世界

You can keep playing while a Text to 3D job runs. When it finishes, the model appears in front of you.文生 3D 任务运行期间,你可以继续游玩。任务完成后,模型会出现在你面前。

  1. Submit: Text to 3D calls lux3d.textTo3d.create and the studio starts following the task.提交:文生 3D 调用 lux3d.textTo3d.create,创作台随即开始跟踪该任务。
  2. Track: a chip on the stage shows the job and its elapsed time. The studio polls /api/aholo/tasks?taskId= every 10 s.跟踪:舞台上的状态标签显示任务及已用时间。创作台每 10 s 轮询一次 /api/aholo/tasks?taskId=。
  3. Fetch: the finished GLB is loaded through /api/aholo/asset, an allowlisted proxy (see Limits & FAQ), so result hosts never need CORS and links never leak to third parties.获取:完成的 GLB 通过 /api/aholo/asset 加载,这是一个带白名单的代理(见 限制与常见问题),因此结果所在的主机无需支持 CORS,链接也不会泄露给第三方。
  4. Drop: the model is scaled to about 70 cm, placed 1.6 m ahead of the camera, and falls from 1.8 m onto the floor found in the voxel grid, bouncing to rest. A toast names the task.投放:模型缩放到约 70 cm,放在镜头前方 1.6 m 处,从 1.8 m 高处落到体素网格中检测到的地面上,弹跳几下后停稳。同时弹出提示,注明对应的任务。
A generated espresso machine dropped onto the floor of the coffee bar
A drop-in in the coffee bar. This one is the cached result used when no key is set, and the toast says so.咖啡吧中的一次投放。这里用的是未设置密钥时的缓存结果,提示中也写明了这一点。

Without a key没有密钥时

  • Text to 3D drops our stored G1-Turbo espresso machine (task 8353472) and labels it cached, so the flow can be tried end to end.文生 3D 会投放我们存储的 G1-Turbo 意式咖啡机(任务 8353472),并标注为缓存结果(cached),这样整个流程也能从头到尾体验一遍。
  • Other Lux3D methods return a receipt marked preview and update the stage where it can (for example selecting the matching prop).其他 Lux3D 方法返回标注为预览(preview)的调用回执,并尽可能同步更新舞台(例如选中对应的道具)。
  • World requests are answered by the closest hosted world (plaza, station or loft, by keyword) and marked cdn preset.世界请求会按关键词匹配最接近的托管世界(广场、车站或公寓)作为回应,并标注为CDN 预设(cdn preset)。

Receipts调用回执

Every call adds a receipt to the dock with the SDK package, method, task or world ID, status and mode (live, preview, cached or cdn preset). That log is the quickest way to see what really ran.每次调用都会在面板中新增一条调用回执,记录 SDK 包、方法、任务或世界 ID、状态和模式(live、preview、cached 或 cdn preset,即实时、预览、缓存结果或 CDN 预设)。想知道实际运行了什么,看这份记录最快。

Live jobs spend credits on the key's account. A G1 mesh took 343 s for us and a SpatialGen world 625 s; keep the tab open while they run.实时任务会消耗该密钥所属账户的额度。我们实测一个 G1 网格用了 343 s,一个 SpatialGen 世界用了 625 s;任务运行期间请保持页面打开。