Lux3d

What This Skill Does

Lux3D generates 3D assets through three documented asynchronous workflows:

• Image to 3D: submit an input image, poll the task, then download the ZIP result.
• Text to 3D: submit a prompt plus style, optionally with a reference image, poll the task, then download the ZIP result.
• Material Repaint: submit a reference image and a model URL, poll the task, then download the regenerated model result.

All workflows require LUX3D_API_KEY, which is the API key obtained from https://labs.aholo3d.com/api-keys.

API Endpoint

• International Endpoint: https://api.aholo3d.com/global

Concurrency Limits

Lux3D limits the number of generation tasks that can be in progress at the same time based on the account plan. Image-to-3D, text-to-3D, and material repaint tasks share the same account-level concurrency quota.

If a task creation endpoint returns GENERATION_CONCURRENCY_LIMIT_EXCEEDED, the account has reached its concurrency limit. No new task is created and no credits are consumed. Wait for an existing task to finish before retrying, or upgrade the account for higher concurrency.

Setup

Apply for an API Key

• Register at: https://labs.aholo3d.com/api-keys

Set Environment Variables

Required:

export LUX3D_API_KEY="your_api_key"

Optional - Override Base URL:

export LUX3D_BASE_URL="https://api.aholo3d.com/global"

Optional - Specify Region:

export LUX3D_REGION="international"

Python Usage

Image to 3D

from skill.lux3d_client import generate_3d_model

result = generate_3d_model("path/to/input.jpg", version="v2.0-preview")
print(result)

Or explicitly specify international region:

result = generate_3d_model("path/to/input.jpg", region="international", version="v2.0-preview")
print(result)

Text to 3D

from skill.lux3d_client import generate_text_to_3d

result = generate_text_to_3d(
    "Generate a high-quality 3D wooden chair",
    style="photorealistic",
    version="v2.0-preview",
)
print(result)

Text plus Reference Image

from skill.lux3d_client import generate_text_to_3d

result = generate_text_to_3d(
    "Generate a premium ceramic vase with a glossy glaze",
    style="glass",
    image_path="path/to/reference.png",
    version="v2.0-preview",
)
print(result)

Low-level Task APIs

from skill.lux3d_client import (
    create_task,
    create_text_to_3d_task,
    create_material_transfer_task,
    query_task_status,
    download_model,
)

image_task_id = create_task("path/to/input.jpg")
text_task_id = create_text_to_3d_task(
    "Generate a stylized toy robot",
    style="cartoon",
    image_path="path/to/reference.png",
)
material_task_id = create_material_transfer_task(
    "path/to/reference.png",
    mesh_url="https://example.com/model.glb",
)

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

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

Material Repaint

from skill.lux3d_client import generate_material_transfer

result = generate_material_transfer(
    "path/to/reference.png",
    mesh_url="https://example.com/model.glb",
    version="v2.0-preview",
)
print(result)

Command Line Usage

Region Selection

Use --region or -r to select the international endpoint (default):

python lux3d_client.py --region international image input.jpg output.zip

Or simply omit the region flag (international is default):

python lux3d_client.py image input.jpg output.zip

Image to 3D

# Historical form (default region)
python lux3d_client.py input.jpg output.zip --version v2.0-preview

# Explicit command
python lux3d_client.py image input.jpg output.zip --version v2.0-preview

Text to 3D

python lux3d_client.py text "Generate a high-quality 3D wooden chair" output.zip --style photorealistic --version v2.0-preview

Text to 3D with Reference Image

python lux3d_client.py text "Generate a futuristic desk lamp" output.zip --style cyberpunk --image ref.png --version v2.0-preview

Material Repaint

python lux3d_client.py material reference.png output.zip --mesh-url https://example.com/model.glb --version v2.0-preview

Text-to-3D Styles

Supported styles:

Lux3D Version

You can specify the Lux3D version via the version parameter:

> Important: If the version parameter is not provided in the request, the system will default to v2.0-preview.

All generation APIs (image-to-3D, text-to-3D, material repaint) support the version parameter.

Specify Version in Python

# Image to 3D with version
result = generate_3d_model("path/to/input.jpg", version="v2.0-preview")

# Text to 3D with version
result = generate_text_to_3d(
    "Generate a high-quality 3D wooden chair",
    style="photorealistic",
    version="v2.0-preview",
)

# Material repaint with version
result = generate_material_transfer(
    "path/to/reference.png",
    mesh_url="https://example.com/model.glb",
    version="v2.0-preview",
)

Specify Version in Command Line

# Image to 3D with version
python lux3d_client.py image input.jpg output.zip --version v2.0-preview

# Text to 3D with version
python lux3d_client.py text "Generate a high-quality 3D wooden chair" output.zip --style photorealistic --version v2.0-preview

# Material repaint with version
python lux3d_client.py material reference.png output.zip --mesh-url https://example.com/model.glb --version v2.0-preview

Output

v2.0-preview Multi-format Output

The v2.0-preview version supports multiple model format outputs. You can choose the appropriate format based on your use case:

Download Different Formats

After task completion, you can append parameters to the result URL to get different formats:

# Get ZIP format (default)
zip_url = result['data']['url'] + '?format=zip'

# Get GLB format
glb_url = result['data']['url'] + '?format=glb'

# Get USDZ format
usdz_url = result['data']['url'] + '?format=usdz'

# Download the corresponding format
download_model(glb_url, "model.glb")

v1.0-pro Output

The v1.0-pro version outputs a lux3d format ZIP package containing:

• A GLB model file
• Complete PBR texture assets (with transparent material support)

Result Validity

All format download links are valid for 2 hours, please download promptly.

Notes

• Authentication uses Authorization header: Authorization:
• Image-to-3D, text-to-3D, and material repaint use different create endpoints
• All three workflows share the same task query endpoint
• prompt and style are required for text-to-3D
• img is optional for text-to-3D and should be a full data URL after encoding
• Material repaint requires img (reference image) and meshUrl (model GLB file URL) parameters

Requirements

pip install Pillow requests

References

• Lux3D Website: https://lux3d.aholo3d.com/
• API Key Application: https://labs.aholo3d.com/api-keys
• API contact: lux3d@qunhemail.com