SkillHub

3daistudio-integration

v1.0.4

Convert images and text prompts to 3D models (.glb) using the 3D AI Studio API. Supports TRELLIS.2, Hunyuan Rapid, and Hunyuan Pro models.

Sourced from ClawHub, Authored by Whale Professor

Installation

Please help me install the skill `3daistudio-integration` from SkillHub official store. npx skills add whale-professor/3daistudio-integration

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