Thrixel CLI

从终端生成 3D 模型

通过 Thrixel CLI 从文本或图像生成模型,将文件保存到本地,并自动化资产流水线。

创建模型
thrixel make '一座带梯子的木制瞭望塔' \
  --engine create \
  --tris 5000 \
  -o watchtower.glb

CLI 功能

生成

Sculpt 生成带纹理的网格。create 引擎将部件保留为独立、可编辑的节点。每条命令都会等待处理完成并保存最终模型。

导出

下载 GLB、FBX、OBJ、STL 或 USDZ,用于游戏引擎、网页体验和 3D 工作流。

脚本与 CI

JSON 输出、独立的进度日志和退出码支持自动化。在 CI 中使用 THRIXEL_API_KEY 进行身份验证。通过 thrixel run 运行单个工具。

工作原理

  1. 安装

    需要 uv。CLI 与 MCP 服务器一同包含在 thrixel-mcp 包中。

    uv tool install thrixel-mcp
  2. 登录

    运行 thrixel login,打开链接,核对代码并批准。CLI 和 MCP 服务器共享已保存的凭据。

    thrixel login
  3. 预览费用

    提交任务前,使用 --dry-run 查看计划步骤和预估 Cubes 用量。通过 thrixel balance 查询余额。

    thrixel make '一座带梯子的木制瞭望塔' --engine create --dry-run

面向编程智能体的 Thrixel

MCP 服务器向编程智能体提供相同的工具。API 支持直接集成到应用和服务中。