SuperAPI AI 工具集

threejs-3d-generator

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:为浏览器 Three.js 游戏生产 3D 资产,底层服务商为 Tripo。支持文本转 3D、图像转 3D,以及贴图、绑定、动画、风格化、格式转换与下载。

主要能力:脚本 threejs_3d_asset.py 提供 text、image、status、download、postprocess、character-pipeline、resume 等子命令。postprocess 支持 texture_model、animate_prerigcheck、animate_rig、animate_retarget、conversion、stylize_model。character-pipeline 可按体型自动路由绑定版本,串联生成、预检、绑定、重定向与下载。

用法:API 密钥通过 --api-key 或环境变量 TRIPO_API_KEY 提供,可用 probe 检查是否已设置。文本转 3D 示例:python3 <this-skill-dir>/scripts/threejs_3d_asset.py text --prompt "..." --model-version v3.1-20260211 --wait --download --out-dir assets/models/xxx。图像转 3D 使用 image 子命令。长任务可省略 --wait,保留任务 ID 或 checkpoint,之后用 resume 恢复。下载 URL 过期快,任务成功后应立即下载。

限制与注意:绑定与动画有较多约束,例如角色需单网格、全身 T/A 姿态、先跑 animate_prerigcheck;人形用 v1.0-20240301,生物用 v2.5-20260210;v1.0 重定向必须用 --out-format fbx;不要传 --animate-in-place。自动绑定不确定,失败可在预算内重试。checkpoint 记录绝对路径,需保留引用文件。密钥不得写入技能文件、游戏代码或报告。具体参数表见 references/api-notes.md,Three.js 集成见 references/threejs-integration.md。