3daistudio

3D AI Studio Skill

Convert images (or text prompts) to 3D models using the 3D AI Studio API.

Credentials

• API Key: Set via THREE_D_AI_STUDIO_API_KEY environment variable
• Base URL: https://api.3daistudio.com
• Get API Key: https://www.3daistudio.com/Platform/API
• Documentation: https://www.3daistudio.com/Platform/API/Documentation

Setup

# Set your API key
export THREE_D_AI_STUDIO_API_KEY="your-api-key-here"

# Run the skill
python 3daistudio.py balance

Available Models

| Model | Endpoint | Input | Credits | Speed | |-------|----------|-------|---------|-------| | Hunyuan Rapid | /v1/3d-models/tencent/generate/rapid/ | Text or image | 35-55 | 2-3 min | | Hunyuan Pro | /v1/3d-models/tencent/generate/pro/ | Text, image, multi-view | 60-100 | 3-6 min | | TRELLIS.2 | /v1/3d-models/trellis2/generate/ | Image only | 15-55 | 25s-4min |

Workflow (ALL models are async)

1. Submit - POST to generation endpoint - get task_id
2. Poll - GET /v1/generation-request/{task_id}/status/ every 10-15s
3. Download - When status == "FINISHED", use results[].asset URL

The script auto-polls and downloads when you use --output.

How to Use

# Check credit balance
python 3daistudio.py balance

# Image to 3D (TRELLIS.2 - fastest, image-only)
python 3daistudio.py trellis --image photo.png --textures -o model.glb

# Image to 3D (Hunyuan Rapid - text or image)
python 3daistudio.py rapid --image photo.png --pbr -o model.glb
python 3daistudio.py rapid --prompt "a red sports car" -o model.glb

# Image to 3D (Hunyuan Pro - highest quality)
python 3daistudio.py pro --image photo.png --pbr --model 3.1 -o model.glb
python 3daistudio.py pro --prompt "a cute blue hedgehog" -o model.glb

# Check status
python 3daistudio.py status 

# Download result
python 3daistudio.py download  -o model.glb

Options

TRELLIS.2

• --image - Path to local image (PNG/JPG/WebP)
• --resolution - 512, 1024 (default), or 1536
• --textures - Enable PBR textures
• --texture-size - 1024, 2048 (default), or 4096

Hunyuan Rapid

• --image - Path to local image
• --prompt - Text description
• --pbr - Enable PBR textures (+20 credits)

Hunyuan Pro

• --image - Path to local image
• --prompt - Text description
• --model - 3.0 or 3.1 (default: 3.1)
• --pbr - Enable PBR textures (+20 credits)
• --generate-type - Normal, LowPoly, Geometry, or Sketch

Credit Costs

TRELLIS.2

| Resolution | Geometry Only | Textured 2048 | Textured 4096 | |-----------|---------------|---------------|---------------| | 512 | 15 | 25 | 30 | | 1024 (default) | 20 | 30 | 40 | | 1536 | 25 | 40 | 55 | | +thumbnail | +2 | +2 | +2 |

Hunyuan

| Edition | Base | +PBR | +Multi-View | Max | |---------|------|------|-------------|-----| | Rapid | 35 | +20 | N/A | 55 | | Pro | 60 | +20 | +20 | 100 |

Tips

• TRELLIS.2 = best for image-to-3D; fast, cheap, great quality
• Hunyuan Rapid = good balance, supports text-to-3D
• Hunyuan Pro = highest quality, supports multi-view input
• Rate limit: 3 requests/minute
• Results expire after 24 hours
• Failed jobs are automatically refunded
• For best TRELLIS results: clean background or transparent PNG

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Lord1Egypt
• Source: Lord1Egypt/awesome-skill-forge
• License: MIT
• Homepage: https://skill-explorer-rho.vercel.app

Install and usage instructions live in the source repository linked above.