{
  "name": "ai3d",
  "display_name": "腾讯混元生3D",
  "description": "基于混元大模型，支持根据文本描述或上传2D图像以及多视角图像，自动生成带PBR材质的高质量 3D 模型。",
  "domain": "ai",
  "api_version": "2025-05-13",
  "endpoint": "ai3d.tencentcloudapi.com",
  "actions": [
    {
      "name": "Convert3DFormat",
      "description": "输入3D模型文件后，可进行3D模型文件格式转换。",
      "status": "online",
      "parameters": [
        {
          "name": "File3D",
          "type": "string",
          "required": true,
          "description": "3D文件url地址，模型文件大小≤60m，支持fbx，obj，glb格式3D文件输入。",
          "example": "url"
        },
        {
          "name": "Format",
          "type": "string",
          "required": true,
          "description": "返回的3D文件格式，参考值：STL, USDZ, FBX, MP4, GIF。",
          "example": "STL"
        }
      ],
      "required": [
        "File3D",
        "Format"
      ]
    },
    {
      "name": "DescribeHunyuanTo3DUVJob",
      "description": "查询组件拆分任务。",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": true,
          "description": "任务ID。",
          "example": "1376862528873414656"
        }
      ],
      "required": [
        "JobId"
      ]
    },
    {
      "name": "DescribeProfileTo3DJob",
      "description": "混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": false,
          "description": "任务ID。",
          "example": "1315932989749215232"
        }
      ],
      "required": []
    },
    {
      "name": "DescribeReduceFaceJob",
      "description": "混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": false,
          "description": "任务ID。",
          "example": "1315932989749215232"
        }
      ],
      "required": []
    },
    {
      "name": "DescribeTextureTo3DJob",
      "description": "混元生3D接口，输入单几何模型和参考图或文字描述后，可生成对应的纹理贴图。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": false,
          "description": "任务ID。",
          "example": "1315932989749215232"
        }
      ],
      "required": []
    },
    {
      "name": "QueryHunyuan3DPartJob",
      "description": "查询组件生成任务。",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": true,
          "description": "任务ID。",
          "example": "1376862528873414656"
        }
      ],
      "required": [
        "JobId"
      ]
    },
    {
      "name": "QueryHunyuanTo3DProJob",
      "description": "混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。 默认提供3个并发，代表最多能同时处理3个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": true,
          "description": "任务ID。",
          "example": "1357237233311637504"
        }
      ],
      "required": [
        "JobId"
      ]
    },
    {
      "name": "QueryHunyuanTo3DRapidJob",
      "description": "混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": false,
          "description": "任务ID。",
          "example": "1315932989749215232"
        }
      ],
      "required": []
    },
    {
      "name": "SubmitHunyuan3DPartJob",
      "description": "输入3D模型文件后，根据模型结构自动进行组件识别生成。",
      "status": "online",
      "parameters": [
        {
          "name": "File",
          "type": "object",
          "required": false,
          "description": "需进行组件生成的3D模型文件，仅支持FBX格式。",
          "example": "无",
          "children": [
            {
              "name": "Url",
              "type": "string",
              "required": true,
              "description": "文件的Url（有效期24小时）",
              "example": "https://cos.ap-guangzhou.myqcloud.com/obj.obj"
            },
            {
              "name": "Type",
              "type": "string",
              "required": true,
              "description": "文件格式",
              "example": "OBJ"
            }
          ]
        },
        {
          "name": "Model",
          "type": "string",
          "required": false,
          "description": "组件生成模型版本，默认为1.5枚举值：1.5： 1.5模型默认值：1.5",
          "example": "1.5"
        }
      ],
      "required": []
    },
    {
      "name": "SubmitHunyuanTo3DProJob",
      "description": "混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。 默认提供3个并发，代表最多能同时处理3个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "Model",
          "type": "string",
          "required": false,
          "description": "混元生3D生成模型版本，默认为3.0，可选项：3.0，3.1选择3.1版本时，LowPoly参数不可用。",
          "example": "3.0"
        },
        {
          "name": "Prompt",
          "type": "string",
          "required": false,
          "description": "文生3D，3D内容的描述，中文正向提示词。最多支持1024个 utf-8 字符。ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。",
          "example": "一只小猫"
        },
        {
          "name": "ImageBase64",
          "type": "string",
          "required": false,
          "description": "输入图 Base64 数据。大小: 单边分辨率要求不小于128，不大于5000，大小≤6m (因base64编码后会大30%左右)格式: jpg，png，jpeg，webp.lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。",
          "example": "/9j/4QlQaHR0c...N6a2M5ZCI"
        },
        {
          "name": "ImageUrl",
          "type": "string",
          "required": false,
          "description": "输入图Url大小: 单边分辨率要求不小于128，不大于5000，大小≤8m格式: jpg，png，jpeg，webp.lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。",
          "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg"
        },
        {
          "name": "MultiViewImages",
          "type": "array",
          "required": false,
          "description": "多视角的模型图片，视角参考值：left：左视图；right：右视图；back：后视图；top：顶视图（仅3.1版本支持）；bottom：底视图（仅3.1版本支持）；left_front：左前45°视图（仅3.1版本支持）；right_front：右前45°视图（仅3.1版本支持）；每个视角仅限制一张图片。●图片大小限制：编码后所有图片大小总和不可超过8M。（base64编码下图片大小总和不超过6M，因base64编码后图片大小会大3...",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "ViewType",
              "type": "string",
              "required": false,
              "description": "视角类型。 取值：back、left、right",
              "example": "back"
            },
            {
              "name": "ViewImageUrl",
              "type": "string",
              "required": false,
              "description": "图片Url地址",
              "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg"
            },
            {
              "name": "ViewImageBase64",
              "type": "string",
              "required": false,
              "description": "图片base64地址",
              "example": "\t/9j/4QlQaHR0c...N6a2M5ZCI"
            }
          ]
        },
        {
          "name": "EnablePBR",
          "type": "boolean",
          "required": false,
          "description": "是否开启 PBR材质生成，默认 false。",
          "example": "true"
        },
        {
          "name": "FaceCount",
          "type": "integer",
          "required": false,
          "description": "生成3D模型的面数，默认值为500000。可支持生成面数范围，参考值：3000-1500000。GenerateType中选择LowPoly时，此参数不生效。取值范围：[3000, 1500000]",
          "example": "100000"
        },
        {
          "name": "GenerateType",
          "type": "string",
          "required": false,
          "description": "生成任务类型，默认Normal，参考值：Normal：可生成带纹理的几何模型。LowPoly：可生成智能拓扑后的模型，FaceCount参数不生效。Geometry：可生成不带纹理的几何模型（白模），EnablePBR参数不生效。Sketch：可输入草图或线稿图生成模型，此模式下prompt和ImageUrl/ImageBase64可一起输入。枚举值：Normal： 可生成带纹理的几何模型LowPoly： 可生成智能拓扑后的模型，FaceCount参数不生效。Geomet...",
          "example": "Normal"
        },
        {
          "name": "PolygonType",
          "type": "string",
          "required": false,
          "description": "该参数仅在GenerateType中选择LowPoly模式可生效。多边形类型，表示模型的表面由几边形网格构成，默认为triangle,参考值:triangle: 三角形面。quadrilateral: 四边形面与三角形面混合生成。",
          "example": "triangle"
        },
        {
          "name": "ResultFormat",
          "type": "string",
          "required": false,
          "description": "生成模型的格式，仅限制生成一种格式； 生成模型文件组默认返回obj、glb格式（开启时Geometry参数时，默认为glb格式）； 可选值：STL，USDZ，FBX；",
          "example": "STL"
        }
      ],
      "required": []
    },
    {
      "name": "SubmitHunyuanTo3DRapidJob",
      "description": "混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "Prompt",
          "type": "string",
          "required": false,
          "description": "文生3D，3D内容的描述，中文正向提示词。 最多支持200个 utf-8 字符。 文生3D, ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。",
          "example": "一只小猫"
        },
        {
          "name": "ImageBase64",
          "type": "string",
          "required": false,
          "description": "输入图 Base64 数据。 大小: 单边分辨率要求不小于128，不大于5000，大小≤6m (因base64编码后会大30%左右) 格式: jpg，png，jpeg，webp. lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。",
          "example": "/9j/4QlQaHR0c...N6a2M5ZCI"
        },
        {
          "name": "ImageUrl",
          "type": "string",
          "required": false,
          "description": "输入图Url 大小: 单边分辨率要求不小于128，不大于5000，大小≤8m 格式: jpg，png，jpeg，webp. lmageBase64、lmageUr和 Prompt必填其一，且Prompt和lmageBase64/mageUr不能同时存在。",
          "example": "https://***.cos.ap-guangzhou.myqcloud.com/***.jpg"
        },
        {
          "name": "ResultFormat",
          "type": "string",
          "required": false,
          "description": "生成模型的格式，仅限制生成一种格式。 生成模型文件组默认返回obj格式。 可选值：OBJ，GLB，STL，USDZ，FBX，MP4。",
          "example": "OBJ"
        },
        {
          "name": "EnablePBR",
          "type": "boolean",
          "required": false,
          "description": "是否开启 PBR材质生成，默认 false。",
          "example": "false"
        },
        {
          "name": "EnableGeometry",
          "type": "boolean",
          "required": false,
          "description": "是否开启单几何生成选项，开启后会生成不带纹理的3D模型（白模）； 开启时，生成模型文件不支持OBJ格式，默认生成模型文件为GLB格式。",
          "example": "false"
        }
      ],
      "required": []
    },
    {
      "name": "SubmitHunyuanTo3DUVJob",
      "description": "输入模型后，可根据模型纹理进行UV展开，输出对应UV贴图。",
      "status": "online",
      "parameters": [
        {
          "name": "File",
          "type": "object",
          "required": false,
          "description": "需进行UV展开的3D文件URL，可支持FBX,OBJ,GLB格式。",
          "example": "无",
          "children": [
            {
              "name": "Url",
              "type": "string",
              "required": true,
              "description": "文件的Url（有效期24小时）",
              "example": "https://cos.ap-guangzhou.myqcloud.com/obj.obj"
            },
            {
              "name": "Type",
              "type": "string",
              "required": true,
              "description": "文件格式",
              "example": "OBJ"
            }
          ]
        }
      ],
      "required": []
    },
    {
      "name": "SubmitProfileTo3DJob",
      "description": "混元生3D接口，基于混元大模型，根据输入的文本描述/图片智能生成3D。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "Profile",
          "type": "object",
          "required": false,
          "description": "真人头像参考图 Base64 数据和参考图 Url。 - Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 - 图片限制：单边分辨率小于4096且大于500，转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png。",
          "example": "Image数据结构",
          "children": [
            {
              "name": "Base64",
              "type": "string",
              "required": false,
              "description": "图片base64",
              "example": "MIIHNjCCBh6gAwIBAgIQCVe4E0h49mzI0NcSqMy1"
            },
            {
              "name": "Url",
              "type": "string",
              "required": false,
              "description": "图片url",
              "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg"
            }
          ]
        },
        {
          "name": "Template",
          "type": "string",
          "required": false,
          "description": "生成人物模板，参考值： basketball: 动感球手； badminton: 羽扬中华； pingpong: 国球荣耀； gymnastics:勇攀巅峰； pilidance: 舞动青春； tennis: 网球甜心； athletics: 东方疾风； footballboykicking1:激情逐风； footballboykicking2: 绿茵之星； guitar:甜酷弦音； footballboy: 足球小将； skateboard: 滑跃青春； futuresoilder: 未来战士； explorer: 逐梦旷野； beardollgirl:可爱女孩； bibpantsboy:都市白领； womansitpose:...",
          "example": "pingpong"
        }
      ],
      "required": []
    },
    {
      "name": "SubmitReduceFaceJob",
      "description": "混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "File3D",
          "type": "object",
          "required": true,
          "description": "源3D模型文件。其中参数 Type 和 Url 必填，参数 PreviewImageUrl 无意义，可忽略。 Type可选值：OBJ，GLB",
          "example": "无",
          "children": [
            {
              "name": "Type",
              "type": "string",
              "required": false,
              "description": "文件格式",
              "example": "OBJ"
            },
            {
              "name": "Url",
              "type": "string",
              "required": false,
              "description": "文件的Url（有效期24小时）",
              "example": "https://cos.ap-guangzhou.myqcloud.com/obj.obj"
            },
            {
              "name": "PreviewImageUrl",
              "type": "string",
              "required": false,
              "description": "预览图片Url",
              "example": "https://cos.ap-guangzhou.myqcloud.com/image.png"
            }
          ]
        },
        {
          "name": "PolygonType",
          "type": "string",
          "required": false,
          "description": "多边形类型，表示模型的表面由几边形网格构成，默认为triangle,参考值: triangle:三角形面。 quadrilateral：四边形面。",
          "example": "triangle"
        },
        {
          "name": "FaceLevel",
          "type": "string",
          "required": false,
          "description": "减面后面数档位类型，可选值：high，medium, low。",
          "example": "high"
        }
      ],
      "required": [
        "File3D"
      ]
    },
    {
      "name": "SubmitTextureTo3DJob",
      "description": "混元生3D接口，输入单几何模型和参考图或文字描述后，可生成对应的纹理贴图。 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。",
      "status": "online",
      "parameters": [
        {
          "name": "File3D",
          "type": "object",
          "required": true,
          "description": "源3D模型文件。 Type可选值：OBJ，GLB",
          "example": "无",
          "children": [
            {
              "name": "Type",
              "type": "string",
              "required": false,
              "description": "文件格式",
              "example": "OBJ"
            },
            {
              "name": "Url",
              "type": "string",
              "required": false,
              "description": "文件的Url（有效期24小时）",
              "example": "https://cos.ap-guangzhou.myqcloud.com/obj.obj"
            },
            {
              "name": "PreviewImageUrl",
              "type": "string",
              "required": false,
              "description": "预览图片Url",
              "example": "https://cos.ap-guangzhou.myqcloud.com/image.png"
            }
          ]
        },
        {
          "name": "Prompt",
          "type": "string",
          "required": false,
          "description": "文生3D，3D内容的描述，中文正向提示词。 最多支持200个 utf-8 字符。 文生3D, image、image_url和 prompt必填其一，且prompt和image/image_url不能同时存在。",
          "example": "一只小猫"
        },
        {
          "name": "Image",
          "type": "object",
          "required": false,
          "description": "3D模型纹理参考图 Base64 数据和参考图图 Url。 - Base64 和 Url 必须提供一个，如果都提供以 Url 为准。 - 图片限制：单边分辨率小于4096且大于128，转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png。",
          "example": "无",
          "children": [
            {
              "name": "Base64",
              "type": "string",
              "required": false,
              "description": "图片base64",
              "example": "MIIHNjCCBh6gAwIBAgIQCVe4E0h49mzI0NcSqMy1"
            },
            {
              "name": "Url",
              "type": "string",
              "required": false,
              "description": "图片url",
              "example": "https://cos.ap-guangzhou.myqcloud.com/image.jpg"
            }
          ]
        },
        {
          "name": "EnablePBR",
          "type": "boolean",
          "required": false,
          "description": "是否开启 PBR材质生成，默认 false。",
          "example": "false"
        }
      ],
      "required": [
        "File3D"
      ]
    }
  ]
}