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

POST

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

Math Magic's first portrait-specific model, developed on v1.5 general architecture. Specifically optimized for face and bust generation with the same four resolution tiers as the general version. Specially trained for human head structures, capable of generating textured realistic facial models. Applicable to digital humans, sculptures, and virtual avatars.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "requestType": "mesh",
    "imageUrl": "https://www.runninghub.cn/view?filename=c97535657efedfe0a98ccafac4911c9458b8f5c100f7a2990b3622262f1e03ed.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM2NTE5MTEzODQsInRzIjoxNzczMDQ3MTExMzg0LCJzaWduIjoiY2NiYjk5OTk3OWQzZWRkYmIzNzU2MWFiM2FkYTAxOTkifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.6567680357081918",
    "resolution": "1536",
    "face": 2000000
}

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/hitem3d-portrait-v15/image-to-3d' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestType": "mesh",
    "imageUrl": "https://www.runninghub.cn/view?filename=c97535657efedfe0a98ccafac4911c9458b8f5c100f7a2990b3622262f1e03ed.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM2NTE5MTEzODQsInRzIjoxNzczMDQ3MTExMzg0LCJzaWduIjoiY2NiYjk5OTk3OWQzZWRkYmIzNzU2MWFiM2FkYTAxOTkifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.6567680357081918",
    "resolution": "1536",
    "face": 2000000
}'

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

Modified at 2026-03-12 04:00:16

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

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