Lux3D

使用 Lux3D 从图片或文本生成 3D 模型（图生 3D、文生 3D）。适用于单物体资产产出，与 AHOLO 世界级 3DGS 重建/生成能力互补。当用户提出图生 3D、文生 3D、prompt 转 3D，或「根据描述/描述+参考图创建 3D 模型」等需求时，可触发本技能。

项目	说明
技能 ID	lux3d
技能包	Lux3D — SkillHub
能力	图生 3D、文生 3D（可选参考图）；异步任务 + 轮询 + 下载 ZIP（含 GLB、PBR 贴图等）
接口规范	本站 API（侧边栏 Lux3D 服务）

文档来源

安装步骤与版本以 SkillHub 技能页 为准；下文为常用说明摘要。API key 与网关请使用国内站（labs.aholo3d.cn、api.aholo3d.cn）。

本技能的功能

Lux3D 通过两个文档化的异步工作流生成 3D 资产：

• 图生 3D：提交输入图片，轮询任务，然后下载 ZIP 结果。
• 文生 3D：提交提示词和风格（可选择附带参考图片），轮询任务，然后下载 ZIP 结果。

两种工作流都需要 LUX3D_API_KEY，在 labs.aholo3d.cn/api-keys 申请。

安装

安装步骤与版本以 SkillHub 为准：

• Lux3D — SkillHub

CLI（推荐）

安装 SkillHub CLI 后执行：

curl -fsSL https://skillhub.cn/install/install.sh | bash
skillhub install lux3d

对话安装

在 SkillHub 技能页 复制「对话安装」提示词，发给 Cursor 等助手代为安装。

Zip

在 SkillHub 技能页 下载压缩包，解压到 Agent 的 skills 目录后重启 Agent。

安装完成后，若使用 OpenClaw、Cursor 等，建议重启一次以便发现新技能。

使用前准备

1. 在 labs.aholo3d.cn/api-keys 申请 API key，配置到运行环境（如 LUX3D_API_KEY）。
2. 请求头：Authorization: <API key>，无需 Bearer 前缀。
3. 可选：覆盖 API 根地址（国内默认如下）：

export LUX3D_API_KEY="your_api_key"
export LUX3D_BASE_URL="https://api.aholo3d.cn"

文档化的 API 根地址：国内 https://api.aholo3d.cn。

依赖要求

pip install Pillow requests

Python 用法

图生 3D：

from lux3d_client import generate_3d_model

result = generate_3d_model("path/to/input.jpg")
print(result)

文生 3D：

from lux3d_client import generate_text_to_3d

result = generate_text_to_3d(
    "生成一个高质量的 3D 木椅",
    style="photorealistic",
)
print(result)

文生 3D + 参考图：

from lux3d_client import generate_text_to_3d

result = generate_text_to_3d(
    "生成一个带有光泽釉面的高级陶瓷花瓶",
    style="glass",
    image_path="path/to/reference.png",
)
print(result)

底层任务 API：

from lux3d_client import (
    create_task,
    create_text_to_3d_task,
    query_task_status,
    download_model,
)

image_task_id = create_task("path/to/input.jpg")
text_task_id = create_text_to_3d_task(
    "生成一个风格化的玩具机器人",
    style="cartoon",
    image_path="path/to/reference.png",
)

image_model_url = query_task_status(image_task_id)
text_model_url = query_task_status(text_task_id)

download_model(image_model_url, "image_to_3d.zip")
download_model(text_model_url, "text_to_3d.zip")

命令行用法

传统图生 3D 写法（仍支持）：

python lux3d_client.py input.jpg output.zip

显式图生 3D：

python lux3d_client.py image input.jpg output.zip

文生 3D：

python lux3d_client.py text "生成一个高质量的 3D 木椅" output.zip --style photorealistic

文生 3D + 参考图：

python lux3d_client.py text "生成一个未来感的台灯" output.zip --style cyberpunk --image ref.png

文生 3D 风格

支持的文档化风格：

• photorealistic — 照片级真实感
• cartoon — 卡通风格
• anime — 动漫风格
• hand_painted — 手绘风格
• cyberpunk — 赛博朋克
• fantasy — 奇幻风格
• glass — 玻璃材质

输出

结果 URL 通常指向 ZIP 包，常见内容包括：

• GLB 模型文件
• PBR 贴图资源

结果 URL 有效期约为 2 小时。

注意事项

• 鉴权使用 HTTP 头：Authorization: <apiKey>
• 图生 3D 与文生 3D 使用不同的创建接口
• 两种流程共用同一任务查询接口
• 文生 3D 必须提供 prompt 与 style
• 文生 3D 的 img 为可选；若提供，需为编码后的完整 data URL

参考资料

• API key：labs.aholo3d.cn/api-keys
• 联系邮箱：lux3d@qunhemail.com
• OpenAPI：本站 API（侧边栏 Lux3D 服务）