跳到主要内容

3D 模型生成

开始​

从GUI开始​

  1. 在Tuanjie AI的对话框中输入prompt生成。
Bridge
  1. 从菜单：AI > 生成 > 生成3D模型, 将会生成Prefab并打开TJGenerators对话窗口。
Bridge Bridge

若TJGenerators对话窗口被关闭， 可选中Prefab后在inspector中找到生成重新打开窗口。

Bridge

从CLI开始​

使用 generate_3d_model_by_tripo_p1 或 generate_3d_model_by_tencent_generation 工具启动生成任务。任务提交后立即返回 task_id 和 prefab_output_path（占位 Prefab），随后调用 place_assets_in_scene 将占位 Prefab 放入场景。生成完成后，真实模型会自动替换占位体。

输入模式：

模式参数说明
文生3Dprompt纯文字描述生成
图生3Dimage_path从参考图生成
文+图prompt + image_path带文字指导的参考图生成
多视图multiview_image_paths（仅 Tripo P1）前/左/后/右 四角度生成，至少3张

异步流程：

  1. 调用 generate_3d_model_by_* → 返回 task_id + 占位 Prefab
  2. 调用 place_assets_in_scene → 占位体立即出现在场景
  3. 结束当前回合，等待 <bg_task_done> 通知自动到达
  4. 收到通知后，真实模型自动替换占位体

常用模型​

Tripo P1（默认选择）​

  • 适用场景： 移动端 / 小游戏 / 低面数 / 通用 3D 资产
  • 模型版本： P1-20260311
  • 输出格式： GLB
  • 面数控制： face_limit 建议范围 48–20000
  • 纹理： 支持 texture、pbr、texture_quality（standard/detailed）
  • 关键参数：
    • prompt（≤1024 字符）
    • image_path：参考图路径
    • multiview_image_paths：多视图路径数组 [front, left, back, right]
    • face_limit：低面控制
    • export_uv：默认 true，关闭可提速并减小体积
    • texture_alignment：original_image / geometry
    • orientation：default / align_image

Hunyuan 3.1（高精度选择）​

  • 适用场景： 高精度 hero 资产 / PBR 材质纹理 / FBX 输出
  • 输出格式： GLB 或 FBX（result_format 参数控制）
  • 面数控制： face_count 范围 1000–2000000，默认 500000
  • 关键参数：
    • prompt（≤1000 字符）
    • image_path：参考图路径
    • face_count：面数
    • enable_pbr：启用 PBR 材质纹理
    • result_format："GLB" 或 "FBX"

模型选择决策​

场景选择
默认/通用/低面/小游戏/移动端Tripo P1
高精度/hero资产/PBR/FBXHunyuan 3.1

如何优化​

提示词优化​

  • 具体描述比模糊描述效果好："a medieval wooden dining chair with carved legs and cushioned seat" > "a chair"
  • 图生3D通常比纯文字效果更可控，提供参考图能大幅提升结果质量
  • 多视图（Tripo P1）能显著提升对称物体和复杂形状的生成精度

面数优化​

  • 移动端/背景道具：face_limit: 5000（Tripo P1）或 face_count: 50000（Hunyuan 3.1）
  • 常规使用：face_limit: 10000（Tripo P1）或 face_count: 200000（Hunyuan 3.1）
  • Hero 资产：face_count: 500000+（Hunyuan 3.1）

性能优化​

  • 关闭 UV 导出（Tripo P1 export_uv: false）：显著提速并减小文件体积，适用于不需要自定义纹理的场景
  • 批量并行：可同时提交多个生成任务
  • 预估耗时： Tripo P1 3–10 分钟，Hunyuan 3.1 约 10 分钟

注意事项​

  • ⚠️ P1-20260311 版本禁止传入参数： quad、smart_low_poly、generate_parts、geometry_quality，传入会导致 API 报错
  • ⚠️ 生成耗时 3–15 分钟，工具调用立即返回，禁止轮询，等待 <bg_task_done> 通知
  • ⚠️ 100% 进度 ≠ 完成：Hunyuan 3.1 在 generating 状态且 progress=100 时，模型文件仍在下载导入中，只有 status="completed" 才代表完成
  • ⚠️ Domain Reload：生成期间不要在磁盘写入 .cs 文件（会触发 domain reload），使用 execute_csharp_script 代替
  • ⚠️ 中断恢复：status="interrupted" 时需用 force_overwrite=true 重新生成
  • ⚠️ 输出路径：默认 Assets/TJGenerators/History/，除非用户明确要求否则不要自定义
  • ⚠️ 地形/景观请使用 generate_terrain，不要用 3D 模型工具生成大尺度地形
  • ⚠️ 带骨骼动画的人形角色请使用 generate_animated_character，不要用静态模型工具