3D AI Studio 技能

使用 3D AI Studio API 将图像（或文本提示）转换为 3D 模型。

认证凭据

• API 密钥：通过 THREE_D_AI_STUDIO_API_KEY 环境变量设置
• 基础 URL： https://api.3daistudio.com
• 获取 API 密钥： https://www.3daistudio.com/Platform/API
• 文档： https://www.3daistudio.com/Platform/API/Documentation

配置方法

# 设置您的 API 密钥
export THREE_D_AI_STUDIO_API_KEY="your-api-key-here"

# 运行技能
python 3daistudio.py balance

可用模型

工作流程（所有模型均为异步）

1. 提交任务 — 向生成端点发送 POST 请求，获得 task_id
2. 轮询状态 — 每 10–15 秒执行一次 GET 请求：/v1/generation-request/{task_id}/status/
3. 下载结果 — 当 status == "FINISHED" 时，使用 results[].asset 中的 URL 下载资产

当您使用 --output 参数运行脚本时，它将自动轮询并下载结果。

使用方法

# 查询账户积分余额
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 "a red sports car" -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 "a cute blue hedgehog" -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 — 生成类型：Normal、LowPoly、Geometry 或 Sketch

积分消耗明细

TRELLIS.2

Hunyuan

使用建议

• TRELLIS.2：最适合图像转 3D；速度快、成本低、质量优秀
• Hunyuan Rapid：综合表现均衡，支持文本生成 3D
• Hunyuan Pro：质量最高，支持多视角图像输入
• 速率限制：每分钟最多 3 次请求
• 结果有效期：24 小时后过期
• 失败任务：自动退还积分
• 提升 TRELLIS.2 效果的建议：使用纯色背景或带透明通道的 PNG 图像