← 返回 Skills 市场

3daistudio integration

Name: 3daistudio integration
Author: whale-professor

作者 Whale Professor · GitHub ↗ · v1.0.4 · MIT-0

cross-platform ✓ 安全检测通过

345

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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.

使用说明 (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_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)

Submit - POST to generation endpoint - get task_id
Poll - GET /v1/generation-request/{task_id}/status/ every 10-15s
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 \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

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install 3daistudio-integration
安装完成后，直接呼叫该 Skill 的名称或使用 /3daistudio-integration 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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

元数据

Slug 3daistudio-integration

版本 1.0.4

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 4

常见问题