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 <task_id>

# Download result
python 3daistudio.py download <task_id> -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