hunyuan3d-v3.1/image-to-3d

Tencent Hunyuan Image-to-3D V3.1 is a professional-grade engine designed to transform 2D images into high-fidelity 3D assets. The defining feature of this version is its support for 8-view synchronous input, which eliminates geometric blind spots and ensures flawless restoration of complex, asymmetrical objects. Powered by a 3.6 billion voxel scale and 1536³ resolution, the model achieves industry-leading consistency between the reference image and the generated mesh. It provides a seamless, production-ready workflow for e-commerce, digital twins, and character design, maintaining exquisite detail from every conceivable angle.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "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"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/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"
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

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