← Back to Skills Marketplace
3daistudio integration
by
Whale Professor
· GitHub ↗
· v1.0.4
· MIT-0
345
Downloads
1
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install 3daistudio-integration
Description
Convert images and text prompts to 3D models (.glb) using the 3D AI Studio API. Supports TRELLIS.2, Hunyuan Rapid, and Hunyuan Pro models.
README (SKILL.md)
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_KEYenvironment 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)
- Submit - POST to generation endpoint - get
task_id - Poll - GET
/v1/generation-request/{task_id}/status/every 10-15s - Download - When
status == "FINISHED", useresults[].assetURL
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 \x3Ctask_id>
# Download result
python 3daistudio.py download \x3Ctask_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
Usage Guidance
This skill appears to do what it says: it sends your API key to 3daistudio and uploads image data (base64) to generate models, then downloads model assets returned by the service. Before installing, confirm you trust https://www.3daistudio.com (review their docs and privacy/security policy) and be aware that: (1) using the skill will consume credits from your account; (2) local images are uploaded to the service; (3) downloaded asset URLs returned by the API are written to disk without content checks—do not open or execute files you don't trust; (4) the repository claims GLB files are ZIPs (that guidance may be inaccurate), so treat conversion instructions with caution. If you need stronger guarantees, consider running the script in an isolated environment (container) and keeping your API key scoped/limited per provider's options.
Capability Analysis
Type: OpenClaw Skill
Name: 3daistudio-integration
Version: 1.0.4
The 3daistudio-integration skill is a standard API wrapper for converting images and text to 3D models. The Python script (3daistudio.py) uses only the standard library (urllib) to interact with the official 3D AI Studio API (api.3daistudio.com), and the instructions in SKILL.md and GUIDE.md are consistent with the stated functionality without any signs of prompt injection, data exfiltration, or malicious execution.
Capability Assessment
Purpose & Capability
Name/description match the code and SKILL.md. The only required secret is THREE_D_AI_STUDIO_API_KEY and the script talks only to https://api.3daistudio.com endpoints for generation, wallet, status, and assets. No unrelated services, binaries, or config paths are requested.
Instruction Scope
Runtime instructions and the script stay within the stated purpose (submit generation requests, poll status, and download results). Note: the script base64-encodes and uploads local image files and will download the asset URL returned by the API and write it to disk without validating MIME type or sandboxing; this is expected for this use-case but means you should only use it with a trusted API/provider and be cautious about the destination path and automatically executing or opening downloaded files.
Install Mechanism
No install spec; it's an instruction-only skill with a small Python script that uses only the standard library (urllib, argparse, base64, json). No remote downloads or archives are fetched during installation.
Credentials
Only one environment variable is required (THREE_D_AI_STUDIO_API_KEY), which is proportionate to the stated API usage. The script does not read other environment variables or credential files.
Persistence & Privilege
The skill does not request persistent or elevated privileges (always is false). It does not modify other skill configs or system-wide settings. It runs as a normal user process and writes only to the output path specified by the user.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install 3daistudio-integration - After installation, invoke the skill by name or use
/3daistudio-integration - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
No functional changes in this version.
- No file changes detected.
- Documentation updated to add structured metadata (name, description, tags, repository, etc.) at the top of SKILL.md.
v1.0.3
Version 1.0.3 of 3daistudio-integration
- No file changes detected for this release.
- No updates or modifications to features, documentation, or functionality.
v1.0.2
- Initial public release with 3daistudio-integration v1.0.1.
- Added documentation: GUIDE.md and README.md files now included.
- Introduced registry.json for skill registration and discovery.
- No breaking changes to core functionality; workflow and API usage remain as before.
v1.0.0
first version
Metadata
Frequently Asked Questions
What is 3daistudio integration?
Convert images and text prompts to 3D models (.glb) using the 3D AI Studio API. Supports TRELLIS.2, Hunyuan Rapid, and Hunyuan Pro models. It is an AI Agent Skill for Claude Code / OpenClaw, with 345 downloads so far.
How do I install 3daistudio integration?
Run "/install 3daistudio-integration" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 3daistudio integration free?
Yes, 3daistudio integration is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 3daistudio integration support?
3daistudio integration is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 3daistudio integration?
It is built and maintained by Whale Professor (@whale-professor); the current version is v1.0.4.
More Skills