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: INLINECODE1
- Get API Key: https://www.3daistudio.com/Platform/API
- Documentation: https://www.3daistudio.com/Platform/API/Documentation
Setup
CODEBLOCK0
Available Models
| Model | Endpoint | Input | Credits | Speed |
|---|
| Hunyuan Rapid | INLINECODE2 | 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 INLINECODE5
- 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
CODEBLOCK1
Options
TRELLIS.2
- -
--image - Path to local image (PNG/JPG/WebP) - INLINECODE11 - 512, 1024 (default), or 1536
- INLINECODE12 - Enable PBR textures
- INLINECODE13 - 1024, 2048 (default), or 4096
Hunyuan Rapid
- -
--image - Path to local image - INLINECODE15 - Text description
- INLINECODE16 - Enable PBR textures (+20 credits)
Hunyuan Pro
- -
--image - Path to local image - INLINECODE18 - Text description
- INLINECODE19 - 3.0 or 3.1 (default: 3.1)
- INLINECODE20 - Enable PBR textures (+20 credits)
- INLINECODE21 - 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
3D AI Studio 技能
使用 3D AI Studio API 将图像（或文本提示）转换为 3D 模型。
凭证
- - API 密钥： 通过 THREEDAISTUDIOAPI_KEY 环境变量设置
- 基础 URL： https://api.3daistudio.com
- 获取 API 密钥： https://www.3daistudio.com/Platform/API
- 文档： https://www.3daistudio.com/Platform/API/Documentation
设置
bash
设置您的 API 密钥
export THREE
DAI
STUDIOAPI_KEY=your-api-key-here
运行技能
python 3daistudio.py balance
可用模型
| 模型 | 端点 | 输入 | 积分 | 速度 |
|---|
| Hunyuan Rapid | /v1/3d-models/tencent/generate/rapid/ | 文本或图像 | 35-55 | 2-3 分钟 |
| Hunyuan Pro |
/v1/3d-models/tencent/generate/pro/ | 文本、图像、多视图 | 60-100 | 3-6 分钟 |
| TRELLIS.2 | /v1/3d-models/trellis2/generate/ | 仅图像 | 15-55 | 25秒-4分钟 |
工作流程（所有模型均为异步）
- 1. 提交 - POST 到生成端点 - 获取 taskid
- 轮询 - 每 10-15 秒 GET /v1/generation-request/{taskid}/status/
- 下载 - 当 status == FINISHED 时，使用 results[].asset URL
使用 --output 时，脚本会自动轮询并下载。
使用方法
bash
检查积分余额
python 3daistudio.py balance
图像转 3D（TRELLIS.2 - 最快，仅图像）
python 3daistudio.py trellis --image photo.png --textures -o model.glb
图像转 3D（Hunyuan Rapid - 文本或图像）
python 3daistudio.py rapid --image photo.png --pbr -o model.glb
python 3daistudio.py rapid --prompt 一辆红色跑车 -o model.glb
图像转 3D（Hunyuan Pro - 最高质量）
python 3daistudio.py pro --image photo.png --pbr --model 3.1 -o model.glb
python 3daistudio.py pro --prompt 一只可爱的蓝色刺猬 -o model.glb
检查状态
python 3daistudio.py status
下载结果
python 3daistudio.py download -o model.glb
选项
TRELLIS.2
- - --image - 本地图像路径（PNG/JPG/WebP）
- --resolution - 512、1024（默认）或 1536
- --textures - 启用 PBR 纹理
- --texture-size - 1024、2048（默认）或 4096
Hunyuan Rapid
- - --image - 本地图像路径
- --prompt - 文本描述
- --pbr - 启用 PBR 纹理（+20 积分）
Hunyuan Pro
- - --image - 本地图像路径
- --prompt - 文本描述
- --model - 3.0 或 3.1（默认：3.1）
- --pbr - 启用 PBR 纹理（+20 积分）
- --generate-type - 普通、低多边形、几何或草图
积分成本
TRELLIS.2
| 分辨率 | 仅几何 | 纹理 2048 | 纹理 4096 |
|---|
| 512 | 15 | 25 | 30 |
| 1024（默认） |
20 | 30 | 40 |
| 1536 | 25 | 40 | 55 |
| +缩略图 | +2 | +2 | +2 |
Hunyuan
| 版本 | 基础 | +PBR | +多视图 | 最大 |
|---|
| Rapid | 35 | +20 | 不适用 | 55 |
| Pro |
60 | +20 | +20 | 100 |
提示
- - TRELLIS.2 = 最适合图像转 3D；快速、便宜、质量高
- Hunyuan Rapid = 良好平衡，支持文本转 3D
- Hunyuan Pro = 最高质量，支持多视图输入
- 速率限制：每分钟 3 个请求
- 结果在 24 小时后过期
- 失败的任务将自动退款
- 为获得最佳 TRELLIS 效果：使用干净背景或透明 PNG
