混元图生3D模型v3.1 - RunningHub-API

目前业界领先的工业级图像转三维模型工具。该版本最大的突破在于支持 8 视图同步输入，通过覆盖顶视、底视及多角度侧视，彻底消除了生成过程中的视觉盲区，实现了对复杂、非对称物体近乎完美的几何还原。配合 1536³ 的超高清分辨率，它能够精准复刻原图中的纹理细节与材质光泽。无论是为电商打造高精度商品模型，还是为游戏开发快速构建 3D 资产，其卓越的多视角一致性算法都能确保模型在任何角度下都经得起专业审视。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "faceCount": 500000,
    "enablePbr": false,
    "generateType": "Normal",
    "imageUrl": "https://www.runninghub.cn/view?filename=20883904a680a207e139a6e4315a3f4c96b5196e8ea8390ddd36f6a6f0d0fd0f.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzA5ODM2NjEzNjYsInRzIjoxNzcwMzc4ODYxMzY2LCJzaWduIjoiZGQzYjNjM2Y3MDU2MDk3MWMzNjliYjc0MDBmNmJkNmQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.2226409500037223",
    "leftImageUrl": "https://www.runninghub.cn/view?filename=4cc16b5bd5440da2960837527d98a3a0022542acc7fbdf5d543ae81b42ebf41a.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzA5ODM2NjEzNjYsInRzIjoxNzcwMzc4ODYxMzY2LCJzaWduIjoiZGQzYjNjM2Y3MDU2MDk3MWMzNjliYjc0MDBmNmJkNmQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8345588173763919",
    "rightImageUrl": "https://www.runninghub.cn/view?filename=fc3f44f6b5556aa5a37ac8058d076c75634649a319e93ff8a9013904051eb90b.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzA5ODM2NjEzNjYsInRzIjoxNzcwMzc4ODYxMzY2LCJzaWduIjoiZGQzYjNjM2Y3MDU2MDk3MWMzNjliYjc0MDBmNmJkNmQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.5182372454992985",
    "backImageUrl": "https://www.runninghub.cn/view?filename=e59f5f8a855944ae2103e3a91c1aead11969e61f6362f81784769290fb1fbbba.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzA5ODM2NjEzNjYsInRzIjoxNzcwMzc4ODYxMzY2LCJzaWduIjoiZGQzYjNjM2Y3MDU2MDk3MWMzNjliYjc0MDBmNmJkNmQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8844219132843462"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.cn/openapi/v2/hunyuan3d-v3.1/image-to-3d' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "faceCount": 500000,
    "enablePbr": false,
    "generateType": "Normal",
    "imageUrl": "https://www.runninghub.cn/view?filename=20883904a680a207e139a6e4315a3f4c96b5196e8ea8390ddd36f6a6f0d0fd0f.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzA5ODM2NjEzNjYsInRzIjoxNzcwMzc4ODYxMzY2LCJzaWduIjoiZGQzYjNjM2Y3MDU2MDk3MWMzNjliYjc0MDBmNmJkNmQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.2226409500037223",
    "leftImageUrl": "https://www.runninghub.cn/view?filename=4cc16b5bd5440da2960837527d98a3a0022542acc7fbdf5d543ae81b42ebf41a.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzA5ODM2NjEzNjYsInRzIjoxNzcwMzc4ODYxMzY2LCJzaWduIjoiZGQzYjNjM2Y3MDU2MDk3MWMzNjliYjc0MDBmNmJkNmQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8345588173763919",
    "rightImageUrl": "https://www.runninghub.cn/view?filename=fc3f44f6b5556aa5a37ac8058d076c75634649a319e93ff8a9013904051eb90b.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzA5ODM2NjEzNjYsInRzIjoxNzcwMzc4ODYxMzY2LCJzaWduIjoiZGQzYjNjM2Y3MDU2MDk3MWMzNjliYjc0MDBmNmJkNmQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.5182372454992985",
    "backImageUrl": "https://www.runninghub.cn/view?filename=e59f5f8a855944ae2103e3a91c1aead11969e61f6362f81784769290fb1fbbba.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzA5ODM2NjEzNjYsInRzIjoxNzcwMzc4ODYxMzY2LCJzaWduIjoiZGQzYjNjM2Y3MDU2MDk3MWMzNjliYjc0MDBmNmJkNmQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.8844219132843462"
}'

返回响应

🟢200成功

application/json

任务结果查询接口：/openapi/v2/query

Body

示例

提交任务响应示例任务完成（查询状态接口）响应示例

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}