Odel
3daistudio skill

3daistudio skill

Local
@whale-professor2PythonMITUpdated 4mo ago

MCP server for 3D AI Studio — generate 3D models from text or images using Hunyuan and TRELLIS

3D AI Studio Skill

A skill for converting images and text prompts to 3D models using the 3D AI Studio API.

Owner

Whale Professor (@WhaleProfessor on Telegram)

Setup

  1. Get an API key from https://www.3daistudio.com/Platform/API
  2. Set the environment variable:
    export THREE_D_AI_STUDIO_API_KEY="your-api-key"
    
    Or copy .env.example to .env and fill in your key.
  3. Run the skill:
    python 3daistudio.py balance
    

Supported Models

ModelInputSpeedCredits
TRELLIS.2Image only25s–4min15–55
Hunyuan RapidText or image2–3min35–55
Hunyuan ProText or image3–6min60–100

Quick Start

# Check balance
python 3daistudio.py balance

# Image to 3D with TRELLIS.2
python 3daistudio.py trellis --image photo.png -o model.glb

# Text to 3D with Hunyuan Rapid
python 3daistudio.py rapid --prompt "a wooden chair" -o chair.glb

# Text to 3D with Hunyuan Pro (best quality)
python 3daistudio.py pro --prompt "a cute blue hedgehog" -o hedgehog.glb

MCP Server

An MCP server is also included for use with Claude Desktop or Claude Code. See mcp-server-3daistudio/ for the installable package, or use mcp_server.py directly as a standalone server.

Documentation

  • GUIDE.md — Full usage guide with all options and examples
  • SKILL.md — Skill metadata and quick reference
  • CLAUDE.md — Instructions for AI agents

License

MIT