Tripo CLI

基于 Bun、OpenTUI 和 Tripo API v3 的 3D 生成命令行工作台。既可以在完整的终端界面中交互操作，也可以通过子命令接入脚本和自动化流程。

功能

• 文本生成 3D、图片生成 3D、多视图生成 3D
• 可绑骨检查、自动绑骨、动画重定向
• 任务状态查询与模型下载
• 模型版本、面数、贴图、PBR、几何质量、UV、低面数和分件等高级参数
• 实时任务进度、等待取消、会话任务历史和响应式终端布局
• 本地图片自动上传，任务成功后立即下载临时模型 URL

安装与配置

bun install
export TRIPO_API_KEY="your-api-key"

API Key 只从进程环境读取，不会由 TUI 写入磁盘。Tripo API 文档见 developers.tripo3d.ai。

交互式 TUI

bun run src/index.tsx
# 或
bun run src/index.tsx --interactive

主要快捷键：

按键	操作
Tab / Shift+Tab	下一个 / 上一个字段
↑ / ↓	修改选择项
Space	切换布尔参数
Ctrl+← / Ctrl+→	切换工作流
F5	提交或查询任务
Esc	停止当前等待；空闲时退出
Ctrl+C	退出

非交互命令

# 文生 3D
bun run src/index.tsx text-to-model "a cute robot" -o robot.glb

# 图生 3D；支持本地文件和 URL
bun run src/index.tsx image-to-model ./reference.png -o model.glb

# 多视图；图片用逗号分隔
bun run src/index.tsx multiview-to-model "front.png,left.png,back.png,right.png" -o model.glb

# 绑骨流水线
bun run src/index.tsx rig-check task_model123
bun run src/index.tsx rig task_model123 --rig-type biped --spec mixamo -o rigged.glb
bun run src/index.tsx retarget task_rig123 "preset:idle,preset:walk" -o animated.glb

# 查询任务，增加 -o 可下载成功任务的模型
bun run src/index.tsx task task_abc123
bun run src/index.tsx task task_abc123 -o result.glb

使用 --help 查看完整参数：

bun run src/index.tsx text-to-model --help

生成命令共享以下高级选项：--model、--face-limit、--no-texture、--no-pbr、--quad、--texture-quality、--geometry-quality、--smart-low-poly、--auto-size、--generate-parts、--no-export-uv、--model-seed 和 --texture-seed。

开发

bun dev              # watch 模式运行 TUI
bunx tsc --noEmit    # 类型检查

项目分为两层：src/api/ 是独立、可注入 fetch 的 Tripo API 客户端；src/cli/ 和 src/tui/ 分别提供非交互与交互界面。