🔒 Security Notice
This skill follows security best practices:
- - ✅ No API keys stored in code - Keys are environment variables
- ✅ Secure communication - All requests use HTTPS
- ✅ Signature verification - MD5 signature on every request
- ✅ Rate limit awareness - Built-in request throttling
- ✅ Input validation - Image format and size checks
- ✅ Timeout protection - Prevents hanging requests
API Key Security
- - 🔑 Never commit API keys to version control
- 🔑 Rotate keys regularly (every 90 days recommended)
- 🔑 Use separate keys for testing and production
- 🔑 Store keys in environment variables, not files
- 🔑 Never log or display full API keys
What is Lux3D
Lux3D is a multimodal 3D generation model developed by Manycore Technology. It converts 2D images into high-quality 3D PBR models that are perfectly compatible with QIZHEN Engine.
How to Use
1. Get API Key
External users need to fill out a questionnaire to apply for an API key:
- - Questionnaire: https://forms.cloud.microsoft.com/r/kRTjdDBV1e
- Or contact: lux3d@qunhemail.com
2. Quick Start
CODEBLOCK0
3. Advanced Usage
CODEBLOCK1
4. Command Line
CODEBLOCK2
5. Output Format
The generated model includes:
- - White model GLB file
- 9 PBR material channel maps
⚠️ Note: Model download URL is valid for 2 hours, please download promptly.
🛡️ Security Best Practices
Environment Variables
Store your API key in environment variables:
CODEBLOCK3
Rate Limiting
The client automatically includes timestamp-based signatures to prevent replay attacks.
Default timeout: 30 seconds per request.
Input Validation
- - Supported formats: JPEG, PNG (automatically converted)
- Maximum image size: Limited by API
- Automatic RGB conversion for non-RGB images
Requirements
CODEBLOCK4
More Information
- - GitHub: https://github.com/manycore-research/ComfyUI-Lux3D
- Email: lux3d@qunhemail.com
🔒 安全须知
本技能遵循安全最佳实践：
- - ✅ 代码中不存储API密钥 - 密钥作为环境变量使用
- ✅ 安全通信 - 所有请求均使用HTTPS协议
- ✅ 签名验证 - 每个请求均附带MD5签名
- ✅ 速率限制感知 - 内置请求节流机制
- ✅ 输入验证 - 检查图片格式与尺寸
- ✅ 超时保护 - 防止请求挂起
API密钥安全
- - 🔑 切勿将API密钥提交至版本控制系统
- 🔑 定期轮换密钥（建议每90天更换一次）
- 🔑 测试环境与生产环境使用独立密钥
- 🔑 将密钥存储于环境变量而非文件中
- 🔑 切勿记录或显示完整API密钥
Lux3D是什么
Lux3D是由群核科技开发的多模态3D生成模型。它能将2D图像转化为高质量3D PBR模型，完美兼容启真引擎。
使用方法
1. 获取API密钥
外部用户需填写问卷申请API密钥：
- - 问卷地址：https://forms.cloud.microsoft.com/r/kRTjdDBV1e
- 或联系：lux3d@qunhemail.com
2. 快速开始
python
from lux3dclient import generate3d_model
设置API密钥（Base64编码的邀请码）
import os
os.environ[LUX3D
APIKEY] = your
invitationcode_here
从图片生成3D模型
result = generate
3dmodel(path/to/your/image.jpg)
print(f模型已保存至: {result})
3. 高级用法
python
from lux3dclient import createtask, querytaskstatus, download_model
步骤1：提交任务
task
id = createtask(path/to/image.jpg)
print(f任务ID: {task_id})
步骤2：轮询获取结果
model
url = querytask
status(taskid)
print(f模型URL: {model_url})
步骤3：下载
download
model(modelurl, output.zip)
4. 命令行
bash
python lux3d_client.py input.jpg output.zip
5. 输出格式
生成的模型包含：
⚠️ 注意：模型下载链接有效期为2小时，请及时下载。
🛡️ 安全最佳实践
环境变量
将API密钥存储于环境变量：
bash
export LUX3D
APIKEY=your
base64encoded_key
速率限制
客户端自动包含基于时间戳的签名以防止重放攻击。
默认超时时间：每个请求30秒。
输入验证
- - 支持格式：JPEG、PNG（自动转换）
- 最大图片尺寸：受API限制
- 非RGB图片自动转换为RGB格式
环境要求
pip install Pillow requests
更多信息
- - GitHub：https://github.com/manycore-research/ComfyUI-Lux3D
- 邮箱：lux3d@qunhemail.com
