hitem3d-portrait-v20/multi-image-to-3d

POST

/openapi/v2/hitem3d-portrait-v20/multi-image-to-3d

数美万物推出的第二代肖像 Portrait v2.0的多视图版本，支持2-4张人像照片输入。通过多视角信息补充提升头部几何完整性和面部特征准确度，适用于需要更稳定面部重建结果的场景。结合v2.0架构的多视角融合能力，为人物3D化提供更可靠的几何基础。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "requestType": "mesh",
    "frontImageUrl": "https://www.runninghub.cn/view?filename=31d97f1d08abd98a1b899edd30903e05eac7ee8e3754c7702184cb0f3b1005d5.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM2NTEyMTUzOTUsInRzIjoxNzczMDQ2NDE1Mzk1LCJzaWduIjoiZWJjYzNhZjNkNTBhNGJmOTY0ZDQ2NDZjYjMwNDUzM2IifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.11741134679512455",
    "backImageUrl": "https://www.runninghub.cn/view?filename=b1674625f01cdb9949125e0d5a63ca7b66cfeaffca064164f386ccf8a81c2e5f.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM2NTEyMTUzOTUsInRzIjoxNzczMDQ2NDE1Mzk1LCJzaWduIjoiZWJjYzNhZjNkNTBhNGJmOTY0ZDQ2NDZjYjMwNDUzM2IifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.6004322286554942",
    "rightImageUrl": "https://www.runninghub.cn/view?filename=2ea5cb557c4a7558fa464ab553890ae162046a4c378a4a3e71a136fe104a1ebe.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM2NTEyMTUzOTUsInRzIjoxNzczMDQ2NDE1Mzk1LCJzaWduIjoiZWJjYzNhZjNkNTBhNGJmOTY0ZDQ2NDZjYjMwNDUzM2IifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.3443195337827565",
    "resolution": "1536pro",
    "face": 2000000
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.cn/openapi/v2/hitem3d-portrait-v20/multi-image-to-3d' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestType": "mesh",
    "frontImageUrl": "https://www.runninghub.cn/view?filename=31d97f1d08abd98a1b899edd30903e05eac7ee8e3754c7702184cb0f3b1005d5.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM2NTEyMTUzOTUsInRzIjoxNzczMDQ2NDE1Mzk1LCJzaWduIjoiZWJjYzNhZjNkNTBhNGJmOTY0ZDQ2NDZjYjMwNDUzM2IifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.11741134679512455",
    "backImageUrl": "https://www.runninghub.cn/view?filename=b1674625f01cdb9949125e0d5a63ca7b66cfeaffca064164f386ccf8a81c2e5f.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM2NTEyMTUzOTUsInRzIjoxNzczMDQ2NDE1Mzk1LCJzaWduIjoiZWJjYzNhZjNkNTBhNGJmOTY0ZDQ2NDZjYjMwNDUzM2IifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.6004322286554942",
    "rightImageUrl": "https://www.runninghub.cn/view?filename=2ea5cb557c4a7558fa464ab553890ae162046a4c378a4a3e71a136fe104a1ebe.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM2NTEyMTUzOTUsInRzIjoxNzczMDQ2NDE1Mzk1LCJzaWduIjoiZWJjYzNhZjNkNTBhNGJmOTY0ZDQ2NDZjYjMwNDUzM2IifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.3443195337827565",
    "resolution": "1536pro",
    "face": 2000000
}'

返回响应

🟢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\": {}}"
}

修改于 2026-03-12 04:00:16

hitem3d-portrait-v20/image-to-3d

hitem3d-portrait-v15/image-to-3d