Lux3D 3D Model Generator

🔒 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: [email protected]

2. Quick Start

from lux3d_client import generate_3d_model

# Set your API key (base64 encoded invitation code)
import os
os.environ["LUX3D_API_KEY"] = "your_invitation_code_here"

# Generate 3D model from image
result = generate_3d_model("path/to/your/image.jpg")
print(f"Model saved to: {result}")

3. Advanced Usage

from lux3d_client import create_task, query_task_status, download_model

# Step 1: Submit task
task_id = create_task("path/to/image.jpg")
print(f"Task ID: {task_id}")

# Step 2: Poll for result
model_url = query_task_status(task_id)
print(f"Model URL: {model_url}")

# Step 3: Download
download_model(model_url, "output.zip")

4. Command Line

python lux3d_client.py input.jpg output.zip

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:

export LUX3D_API_KEY="your_base64_encoded_key"

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

pip install Pillow requests

More Information

• GitHub: https://github.com/manycore-research/ComfyUI-Lux3D
• Email: [email protected]