Hunyuan3d（多接口集成）

🔖 混元生3D生成模型版本

• 默认值：3.0
• 注意事项：选择3.1版本时，LowPoly参数不可用

✨ 文生3D中文正向提示词

• 字符限制：最多支持1024个utf-8字符
• 填写规则：与ImageBase64、ImageUrl三选一必填，且不可与后两者同时存在

🖼️ 图生3D Base64编码图像

• 填写规则：与Prompt、ImageUrl三选一必填，且不可与Prompt同时存在
• 辅助说明：优先基于图像编码生成3D模型，对应3D内容描述需求

🔗 图生3D输入图像URL

• 大小限制：单边分辨率≥128且≤5000，文件大小≤8M
• 格式限制：支持jpg、png、jpeg、webp
• 填写规则：与Prompt、ImageBase64三选一必填，且不可与Prompt同时存在

📸 多视角图像集合（提升3D模型生成精度）

• 视角支持：3.0版本支持left、right、back；3.1版本额外支持top、bottom、left_front、right_front
• 上传限制：每个视角仅可上传1张图片
• 大小限制：编码后总大小≤8M（Base64编码前≤6M，编码后大小约增加30%）
• 分辨率限制：单边分辨率≥128且≤5000
• 格式限制：支持jpg、png

🎨 PBR材质生成开关

• 功能说明：开启后生成基于物理的渲染（PBR）材质，提升3D模型材质真实感
• 默认值：false

📏 3D模型面数设置

• 核心说明：面数越多，模型细节越丰富，文件体积也越大
• 默认值：500000
• 常规范围（GenerateType=Normal/Geometry/Sketch）：10000 - 1500000
• LowPoly模式范围（GenerateType=LowPoly）：3000 - 1500000

🎯 3D模型生成任务类型

• Normal：生成带纹理的几何模型（默认值）
• LowPoly：生成智能拓扑模型，面数最低可至3000面（仅Model=3.0支持）
• Geometry：生成无纹理几何模型（白模），此模式下EnablePBR参数不生效
• Sketch：草图/线稿图生成模型，此模式下Prompt和ImageUrl/ImageBase64可同时输入

🔺 模型多边形网格类型（仅GenerateType=LowPoly生效）

• triangle：三角形面（默认值）
• quadrilateral：四边形面与三角形面混合生成

📦 3D模型输出格式（仅支持选择一种）

• 默认格式：obj、glb（GenerateType=Geometry时，仅默认输出glb）
• 可选自定义格式：STL、USDZ、FBX

✨ 文生3D核心参数

• 功能：3D内容的中文正向描述提示词
• 限制：最多支持1024个utf-8字符
• 规则：与ImageBase64、ImageUrl三选一必填，且不可与后两者同时存在

🖼️ 图生3D（Base64格式）

• 功能：基于输入图像生成3D内容，传入图像的Base64编码字符串
• 限制：最多支持1024个utf-8字符
• 规则：与Prompt、ImageUrl三选一必填，且不可与Prompt同时存在

🔗 图生3D（URL格式）

• 功能：基于输入图像生成3D内容，传入图像的有效网络URL
• 分辨率限制：图像单边分辨率≥128且≤5000
• 大小限制：文件大小≤8M
• 格式支持：jpg、png、jpeg、webp
• 规则：与Prompt、ImageBase64三选一必填，且不可与Prompt同时存在

📦 3D模型输出格式

• 功能：指定生成3D模型的单一输出格式
• 默认规则：未指定时，关闭Geometry返回obj、glb；开启Geometry仅返回glb
• 可选格式：以下枚举值

🎨 PBR材质生成开关

• 功能：是否开启基于物理的渲染（PBR）材质生成
• 默认值：false（不开启）

🧱 单几何白模生成开关

• 功能：是否开启单几何生成，开启后生成无纹理的3D白模
• 格式限制：开启后不支持OBJ格式，默认输出GLB格式
• 默认值：false（不开启）

📂 源3D模型文件（必填项）

• 包含模型格式类型（Type）和模型文件URL（Url）两个必填子字段
• Type仅支持指定枚举格式，不可自定义

✨ 文生3D中文正向提示词

• 字符限制：最多支持200个utf-8字符
• 填写规则：与Image、ImageUrl三选一必填，且不可与后两者同时存在

🖼️ 3D模型纹理参考图（Base64编码或网络URL）

• 优先级规则：Base64和Url二选一提供，两者均提供时优先使用Url
• 分辨率限制：图像单边分辨率≥128且≤4096
• 大小限制：Base64编码后字符串大小≤10MB
• 格式限制：支持jpg、jpeg、png

🎨 PBR材质生成开关

• 功能说明：开启后生成基于物理的渲染（PBR）材质，提升3D模型纹理真实感
• 默认值：false

📂 源3D模型文件（必填项）

• 包含两个必填子字段：模型格式类型（Type）、模型文件网络URL（Url）
• Type仅支持枚举格式，不可自定义填写

🔺 模型多边形网格类型

• 功能说明：定义3D模型表面的网格构成形状
• 默认值：triangle
• 可选值说明：
  1. triangle：三角形面
  2. quadrilateral：四边形面

📏 模型减面后数档位类型

• 功能说明：定义3D模型减面操作后的面数保留档位（精度等级）
• 可选值说明：
  1. high：高档位（保留较多面数，模型细节更完整）
  2. medium：中档位（平衡细节与文件体积）
  3. low：低档位（保留少量面数，文件体积最小）

📂 需进行组件生成的3D模型文件（必填项）

• 包含两个必填子字段：模型格式类型（Type）、模型文件网络URL（Url）
• 格式限制：仅支持FBX格式，不可选择其他格式

🔖 组件生成模型版本

• 默认值：1.0
• 可选值说明：
  1. 1.0：基础版本（示例值）
  2. 1.5：升级版本