一、API调用与模型自动获取
第一步：注册 Tripo3D API并获取密钥
登录Tripo3D开发者平台（developer.tripo3d.ai），注册账号后在API管理页面获取API Key。免费账号有每日调用次数限制（通常50-100次/天），对于批量模型生成足够使用。API以RESTful方式工作，支持文生3D（Text-to-3D）和图生3D（Image-to-3D）两种模式。文生模式通过POST请求发送文本提示词，图生模式上传参考图片的URL地址。
第二步：用Python写一个批量文生3D脚本
创建一个简单的Python脚本调用Tripo3D的API。核心逻辑：发送POST请求创建生成任务→轮询GET请求检查任务状态→任务完成后下载STL文件。建议将提示词列表保存在CSV文件中，让脚本逐条读取并自动处理。超时设置150-300秒（AI生成一般需要1-3分钟），用time.sleep(5)间隔轮询避免触发API限流。将结果模型自动保存到指定文件夹，文件名使用提示词的缩写。
| API操作 | 端点URL | 方法 | 参数说明 |
|---|---|---|---|
| 创建任务 | /api/v1/text-to-3d | POST | prompt：文本提示词 |
| 查询状态 | /api/v1/tasks/{id} | GET | id：任务ID |
| 下载模型 | /api/v1/models/{id} | GET | format：stl/obj/glb |
| 图生3D | /api/v1/image-to-3d | POST | image_url：图片URL |
二、 Blender Python脚本实现自动化修复
第一步：编写减面与水密性修复脚本
AI生成模型的三角面数通常在数万到数百万之间，直接导入切片软件会导致卡顿。在Blender中启动Python控制台，用bpy库编写减面脚本。核心逻辑：导入STL→用decimate_modifier将面数降低到5-10万面→用solidify_modifier检查壁厚并生成0.8mm的实体壁厚→用3D Print Toolbox插件检测并自动修复水密性问题。将以上步骤保存为一个.py文件，通过Blender的batch mode（blender -P script.py）批量处理文件夹中的所有STL文件。
第二步：自动化支撑检测与添加
通过Blender脚本检测模型中的悬垂面角度——扫描所有法线朝下的三角面，计算其与水平面的夹角。当角度小于45度时标记为需要支撑的区域。虽然Blender无法直接生成FDM支撑，但可以将标记区域的顶点位置导出为坐标文件，供OrcaSlicer在切片时参考调整支撑位置。更实用的方式是在Blender脚本中自动判断模型是否需要多角度分件打印，将需支撑的结构切分为多个免支撑的独立部件。
第三步：批量导出为切片软件兼容格式
将修复完成、减面到位的模型统一导出为STL格式。在导出脚本中设置：坐标轴方向归一化（确保模型底部朝下）、文件命名规范化（原文件名+修复标识+面数信息）、统一缩放至毫米单位。导出后的模型直接拖入OrcaSlicer或 Bambu Studio 即可使用，无需手动修复。
三、常见错误与避坑指南
误区一：API Key硬编码在脚本中。将API Key保存到环境变量或单独的config.py中，避免代码上传到GitHub时泄露。误区二：减面幅度过大导致细节丢失。保持5-10万面是FDM打印的黄金平衡点，低于2万面时圆形特征会明显变形。误区三：没有处理脚本异常。AI生成有时会超时失败，脚本中加入重试逻辑（最多重试3次）和异常处理，将失败任务记录到日志文件便于后续手动处理。
四、FAQ
问：我没有Python基础，能用这套方案吗？
这套方案要求至少了解Python基本语法和Blender操作基础。如果你是纯新手，可以先从tripo3d.ai的网页版开始手工操作，等对工作流熟悉后再学习脚本化。网上有免费的Blender Python入门教程（搜索"Blender Python scripting for beginners"）。
问：Tripo3D API的免费额度够用吗？
免费账号每天50-100次调用，对个人爱好者完全够用。如果需要大量生成，付费方案通常0.1-0.5美元/次。建议先用网页版手工操作熟悉流程，确定需要批量生成时再启用API。
问：Blender Python脚本可以在不打开Blender窗口的情况下运行吗？
可以。Blender的batch mode（blender --background -P script.py）可以在后台无头运行，不占用桌面空间，适合在服务器上自动化批量处理。Windows上在命令行中运行即可。