Lux3D 国内版 3D 生成

解决的问题

3D 资产生成接口往往把创建、轮询、格式选择和结果提取分散在多个 HTTP 请求中，本地文件、多视角图片、版本参数和输出格式也容易在调用链里出错。Lux3d-cn 将 Lux3D 国内 API 的常用路径收敛到 lux3d_client.py，适合需要把图生 3D、文生 3D、材质重绘和导出流程接入脚本或自动化任务的工程师。

工作方式

• 前置约束：所有 img、imgs、meshUrl、modelUrl 必须是 HTTP(S) URL；国内 API Key 与国际端点不通用，鉴权头直接传 API Key。
• 核心能力：image 支持 G1 与 G1-Turbo，text 支持 prompt、style 与单张参考图，material 使用 v3.0-standard 重绘 GLB 材质，four-view 补齐多视角图片，export 在 zip/glb/usdz/obj_zip/fbx_zip 间转换。
• 任务流程：创建接口返回 taskid，随后通过 query 或 Python query_task_status 轮询；成功后从 d.outputs[].content 读取结果 URL，并建议尽快保存，因为有效期为 2 小时。
• 参数边界：img 与 imgs 只能二选一；imgs 支持 1-32 个同一主体图片；faceCount 为 10000 到 300000；enablePbr 仅用于含 ZIP/GLB 的 G1-Turbo 或文生 Turbo 场景。

适用边界

该技能面向 Lux3D 国内环境，不提供业务类型或内部版本能力。四视图只是可选增强链路，不是 G1-Turbo 的前置条件；export 接收的 ZIP 必须来自 Lux3D 生成任务。免费账号与 Pro 账号分别有 2 和 5 个并发任务，遇到并发限制时应等待已有任务结束。