tripo_generate_text
Generate 3D models from text prompts with texture, PBR, and face-count options, then save the result as a GLB file for 3D workflows.
Instructions
文字生成 3D 模型（Studio 订阅额度，H3.1 基准约 55 积分/次）。对应内部接口 operation/text_to_model，参数名与官方文档 text_to_model 一致。默认阻塞等待完成并下载 GLB。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "tripo_generate_text"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pbr | No | PBR 材质，默认 true；为 true 时 texture 被强制为 true | |
| quad | No | 四边面输出，默认 false；开启后输出为 FBX 且面数不超过 150,000 | |
| prompt | Yes | 提示词，英文效果更好 | |
| texture | No | 是否生成贴图，默认 true | |
| compress | No | 纹理压缩方式，默认 meshopt；geometry 需要在建模软件里先解压 | |
| out_path | No | 保存路径，默认 tripo-out/<prompt>.glb | |
| auto_size | No | 按真实世界尺寸（米）缩放，默认 false | |
| export_uv | No | 生成阶段是否做 UV 展开，默认 true；设 false 更快、模型更小 | |
| face_limit | No | 面数上限，不填自适应。v3.1/v3.0 detailed 最多 2,000,000、standard 1,500,000；v2.5 最多 500,000；quad=true 时不超过 150,000 | |
| model_seed | No | 几何随机种子，固定可复现（v2.0 及以上） | |
| visibility | No | 模型可见性，默认 shareable | |
| face_preset | No | 面数预设：low 3万 / medium 15万 / high 80万，优先于 face_limit；游戏资产和 3D 打印建议 low 或 medium | |
| orientation | No | 自动旋转对齐原图，默认 default；仅 texture=true 时生效 | |
| texture_seed | No | 贴图随机种子（v2.0 及以上） | |
| wait_seconds | No | 阻塞等待上限，默认 480 秒；超时会返回 id，稍后用 tripo_download 取模型 | |
| model_version | No | 模型版本，默认 v3.1-20260211（H3.1）。v3.0 = H3.0 快速，v2.5 = H2.5 经典；Nexus-v1.0 / Nexus-v2.0 = 智能网格 P1.0 / P2.0（对应官方 API 的 P1，输出干净拓扑低模） | |
| generate_parts | No | 分部件生成，默认 false；与 texture/pbr/quad 不兼容 | |
| smart_low_poly | No | 手搓拓扑低模，默认 false；输入复杂时可能失败 | |
| texture_quality | No | 贴图质量，默认 detailed；standard 为基准，detailed +20、extreme +30 积分 | |
| geometry_quality | No | 几何精度，默认 detailed（Ultra） | |
| texture_alignment | No | 贴图对齐倾向：忠于原图 / 忠于几何，默认 original_image |