ਸਮੱਗਰੀ ਵੱਲ ਜਾਓ

Hunyuan3d V3 · Image to 3D

ਇੰਟੀਗ੍ਰੇਟ ਕਰੋ

ਮਾਡਲ id hunyuan3d-v3/image-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ਉਦਾਹਰਨ ਵਰਗੀਆਂ ਫ਼ਾਈਲਾਂ: $0.375 375 API ਕ੍ਰੈਡਿਟ · ≈ ₽40.24 ਤੁਹਾਡੀਆਂ ਫ਼ਾਈਲਾਂ ਚਲਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਮਾਪੀਆਂ ਜਾਂਦੀਆਂ ਹਨ ਇਸ ਪੰਨੇ ’ਤੇ ਚਲਾਓ

API ਕੁੰਜੀ ਲਵੋ

ਵਿਕਲਪਿਕ back/left/right ਵਿਊਜ਼, PBR ਅਤੇ low-poly ਮੋਡਾਂ ਵਾਲਾ Hunyuan3D V3 image-to-3D

Tencent · 3D

ਤੁਹਾਡਾ ਪਹਿਲਾ ਨਤੀਜਾ ਇੱਥੇ ਹੋਵੇਗਾ

ਹੇਠਾਂ ਬੇਨਤੀ ਬਣਾਓ ਅਤੇ ਆਪਣੀ API ਕੁੰਜੀ ਨਾਲ ਚਲਾਓ। ਆਉਟਪੁੱਟ ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਕਾਪੀ ਕੀਤੇ ਜਾਂਦੇ ਹਨ ਅਤੇ ਹਮੇਸ਼ਾ ਲਈ ਜਾਂ ਮੁਫ਼ਤ ਵਿੱਚ 7 ਦਿਨ ਤੱਕ ਰੱਖੇ ਜਾਂਦੇ ਹਨ।

ਰਿਕਵੈਸਟ ਬਣਾਓ

ਕੰਟਰੋਲ ਮਾਡਲ ਸਕੀਮਾ ਤੋਂ ਤਿਆਰ ਹੁੰਦੇ ਹਨ। ਤੁਸੀਂ ਬਦਲਾਅ ਕਰਦੇ ਹੀ ਕੋਡ ਅਤੇ ਕੀਮਤ ਅੱਪਡੇਟ ਹੋ ਜਾਂਦੇ ਹਨ।

•ਲੋੜੀਂਦਾ
ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

3D ਮਾਡਲ ਸਿਰਜਣਾ ਲਈ ਵਰਤਿਆ ਜਾਣ ਵਾਲੇ ਚਿੱਤਰ ਦਾ URL।

ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

ਬੈਕ-ਵਿਊ ਚਿੱਤਰ ਦਾ URL, 3D ਪੁਨਰ-ਨਿਰਮਾਣ ਸੁਧਾਰਨ ਲਈ ਵਿਕਲਪਿਕ ਤੌਰ 'ਤੇ ਦਿੱਤਾ ਜਾ ਸਕਦਾ ਹੈ।

ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

ਖੱਬੇ ਦ੍ਰਿਸ਼ ਵਾਲੇ ਚਿੱਤਰ ਦਾ URL, 3D ਪੁਨਰ-ਨਿਰਮਾਣ ਸੁਧਾਰਨ ਲਈ ਵਿਕਲਪਿਕ ਤੌਰ 'ਤੇ ਦਿੱਤਾ ਜਾ ਸਕਦਾ ਹੈ।

ਫ਼ਾਈਲ ਛੱਡੋ, ਜਾਂ

ਸੱਜੇ ਦ੍ਰਿਸ਼ ਵਾਲੇ ਚਿੱਤਰ ਦਾ URL, 3D ਪੁਨਰ-ਨਿਰਮਾਣ ਸੁਧਾਰਨ ਲਈ ਵਿਕਲਪਿਕ ਤੌਰ 'ਤੇ ਦਿੱਤਾ ਜਾ ਸਕਦਾ ਹੈ।

generate_type ਡਿਫ਼ਾਲਟ Normal

ਸਿਰਜਣਾ ਮੋਡ: `Normal` ਟੈਕਸਚਰਯੁਕਤ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ; `LowPoly` ਪੌਲੀਗਨ ਘਟਾਉਂਦਾ ਹੈ; `Geometry` ਬਿਨਾਂ ਟੈਕਸਚਰ ਵਾਲਾ ਸਫ਼ੈਦ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ।

ਡਿਫ਼ਾਲਟ 500000

ਫੇਸਾਂ ਦੀ ਇੱਛਿਤ ਗਿਣਤੀ, 40,000 ਤੋਂ 1,500,000 ਤੱਕ।

ਉੱਨਤ polygon_type · enable_safety_checker
polygon_type ਡਿਫ਼ਾਲਟ triangle

ਪੌਲੀਗਨ ਦੀ ਕਿਸਮ, ਸਿਰਫ਼ ਤਾਂ ਲਾਗੂ ਹੁੰਦੀ ਹੈ ਜੇ `GenerateType` `LowPoly` ਹੋਵੇ।

POST /run/hunyuan3d-v3/image-to-3d?wait=20 ਕੋਟ → $0.375
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/hunyuan3d-v3/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ਇਹ ਬੇਨਤੀ ਚਲਾਓ

ਤੁਹਾਡੀ key ਇਸ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਰਹਿੰਦੀ ਹੈ: ਇਹ ਸਿਰਫ਼ Doitong API ਨੂੰ ਭੇਜੀ ਜਾਂਦੀ ਹੈ ਅਤੇ ਸਿਰਫ਼ ਤਾਂ ਹੀ (localStorage) ਵਿੱਚ ਸੁਰੱਖਿਅਤ ਹੁੰਦੀ ਹੈ ਜੇ ਤੁਸੀਂ Remember ਚੁਣੋ। API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

Hunyuan3d V3 · Image to 3D ਬਾਰੇ

`input_image_url` ਤੋਂ 3D ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ। ਰੀਕੰਸਟਰਕਸ਼ਨ ਸੁਧਾਰਨ ਲਈ ਵਿਕਲਪਿਕ `back_image_url`, `left_image_url` ਅਤੇ `right_image_url` ਦਿੱਤੇ ਜਾ ਸਕਦੇ ਹਨ। `generate_type` Normal, LowPoly ਜਾਂ Geometry (ਬਿਨਾਂ ਟੈਕਸਚਰ) ਚੁਣਦਾ ਹੈ, ਅਤੇ `polygon_type` LowPoly ਲਈ triangle ਜਾਂ quadrilateral ਚੁਣਦਾ ਹੈ। `enable_pbr` PBR ਮਟੀਰੀਅਲ ਜੋੜਦਾ ਹੈ ਅਤੇ `face_count` 40000 ਤੋਂ 1500000 ਤੱਕ ਹੁੰਦਾ ਹੈ। ਇੱਕ GLB, ਹੋਰ ਫਾਰਮੈਟਾਂ ਦੇ URL ਅਤੇ ਥੰਬਨੇਲ ਵਾਪਸ ਕਰਦਾ ਹੈ।

ਪੈਰਾਮੀਟਰ

ਨਾਮਕਿਸਮ ਡਿਫ਼ਾਲਟਮਨਜ਼ੂਰਸ਼ੁਦਾ ਵੇਰਵਾ
input_image_urlਲੋੜੀਂਦਾ
ਕਿਸਮurl · image
3D ਮਾਡਲ ਸਿਰਜਣਾ ਲਈ ਵਰਤਿਆ ਜਾਣ ਵਾਲੇ ਚਿੱਤਰ ਦਾ URL।
enable_safety_checkerਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟtrue
false ਸੈੱਟ ਕਰਕੇ ਸਕ੍ਰੀਨਿੰਗ ਨੂੰ ਢਿੱਲਾ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ, ਜੇ ਕਾਲਰ ਅਧਿਕਾਰਤ ਹੋਵੇ।
back_image_urlਵਿਕਲਪਿਕ
ਕਿਸਮurl · image
ਬੈਕ-ਵਿਊ ਚਿੱਤਰ ਦਾ URL, 3D ਪੁਨਰ-ਨਿਰਮਾਣ ਸੁਧਾਰਨ ਲਈ ਵਿਕਲਪਿਕ ਤੌਰ 'ਤੇ ਦਿੱਤਾ ਜਾ ਸਕਦਾ ਹੈ।
left_image_urlਵਿਕਲਪਿਕ
ਕਿਸਮurl · image
ਖੱਬੇ ਦ੍ਰਿਸ਼ ਵਾਲੇ ਚਿੱਤਰ ਦਾ URL, 3D ਪੁਨਰ-ਨਿਰਮਾਣ ਸੁਧਾਰਨ ਲਈ ਵਿਕਲਪਿਕ ਤੌਰ 'ਤੇ ਦਿੱਤਾ ਜਾ ਸਕਦਾ ਹੈ।
right_image_urlਵਿਕਲਪਿਕ
ਕਿਸਮurl · image
ਸੱਜੇ ਦ੍ਰਿਸ਼ ਵਾਲੇ ਚਿੱਤਰ ਦਾ URL, 3D ਪੁਨਰ-ਨਿਰਮਾਣ ਸੁਧਾਰਨ ਲਈ ਵਿਕਲਪਿਕ ਤੌਰ 'ਤੇ ਦਿੱਤਾ ਜਾ ਸਕਦਾ ਹੈ।
enable_pbrਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟfalse
PBR ਮਟੀਰੀਅਲ ਸਿਰਜੋ, ਜਦੋਂ ਤੱਕ generate_type Geometry ਨਾ ਹੋਵੇ; ਉਸ ਸਥਿਤੀ ਵਿੱਚ ਇਸ ਸੈਟਿੰਗ ਦਾ ਕੋਈ ਪ੍ਰਭਾਵ ਨਹੀਂ ਹੁੰਦਾ।
face_countਵਿਕਲਪਿਕ
ਕਿਸਮinteger
ਡਿਫ਼ਾਲਟ500000
40,000 – 15,00,000
ਫੇਸਾਂ ਦੀ ਇੱਛਿਤ ਗਿਣਤੀ, 40,000 ਤੋਂ 1,500,000 ਤੱਕ।
generate_typeਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟNormal
NormalLowPolyGeometry
ਸਿਰਜਣਾ ਮੋਡ: `Normal` ਟੈਕਸਚਰਯੁਕਤ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ; `LowPoly` ਪੌਲੀਗਨ ਘਟਾਉਂਦਾ ਹੈ; `Geometry` ਬਿਨਾਂ ਟੈਕਸਚਰ ਵਾਲਾ ਸਫ਼ੈਦ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ।
polygon_typeਵਿਕਲਪਿਕ
ਕਿਸਮenum
ਡਿਫ਼ਾਲਟtriangle
trianglequadrilateral
ਪੌਲੀਗਨ ਦੀ ਕਿਸਮ, ਸਿਰਫ਼ ਤਾਂ ਲਾਗੂ ਹੁੰਦੀ ਹੈ ਜੇ `GenerateType` `LowPoly` ਹੋਵੇ।
ਲੋੜੀਂਦਾ

ਫ਼ਾਈਲ ਪੈਰਾਮੀਟਰ ਜਨਤਕ https:// URL, 10 MB ਤੱਕ ਦਾ data: URI, ਜਾਂ ਅੱਪਲੋਡ ਦੇ file_url ਨੂੰ ਸਵੀਕਾਰਦੇ ਹਨ। ਫ਼ਾਈਲਾਂ

ਆਉਟਪੁੱਟ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan3d-v3/image-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 375,
    "usd": "0.375",
    "charged": 375,
    "refunded": 0
  },
  "input": {
    "input_image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "obj": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "usdz": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ਤੁਹਾਡੀਆਂ ਫ਼ਾਈਲਾਂ, ਤੁਹਾਡੀ ਚੋਣਹਰ outputs[].url ਸਾਡੇ ਸਟੋਰੇਜ ਵਿੱਚ ਇੱਕ ਕਾਪੀ ਹੈ: ਹਮੇਸ਼ਾ ਲਈ ਰੱਖੀ ਜਾਂਦੀ ਹੈ (ਪ੍ਰਤੀ GB-ਮਹੀਨਾ ਭੁਗਤਾਨ) ਜਾਂ 7 ਦਿਨ ਤੱਕ ਮੁਫ਼ਤ, ਤੁਹਾਡੀ ਖਾਤਾ ਸੈਟਿੰਗ ਜਾਂ ?storage= ਅਨੁਸਾਰ।
ਹਰ ਮਾਡਲ ’ਤੇ ਇੱਕੋ ਜਿਹਾ ਰੂਪਤਸਵੀਰਾਂ, ਵੀਡੀਓ ਅਤੇ ਆਡੀਓ ਸਭ ਲਈ type, url, content_type, width, height ਅਤੇ duration। output ਮਾਡਲ ਦਾ ਆਪਣਾ ਨਤੀਜਾ ਆਬਜੈਕਟ ਹੈ।
ਆਉਟਪੁੱਟ ਦੇ ਫ਼ੀਲਡ
model_glb
object {url, content_type, file_name, file_size}ਸਿਰਜੀ ਗਈ 3D ਵਸਤੂ ਵਾਲੀ GLB ਫ਼ਾਈਲ।
thumbnail
object {url, content_type, file_name, file_size} | nullਸਿਰਜੇ ਗਏ ਮਾਡਲ ਦੀ ਝਲਕ ਦਿਖਾਉਣ ਵਾਲਾ ਥੰਬਨੇਲ।
model_urls
object {glb, fbx, obj, usdz}ਵੱਖ-ਵੱਖ ਫਾਰਮੈਟਾਂ ਵਿੱਚ 3D ਮਾਡਲ ਦੇ ਲਿੰਕ।
seed
integer | nullਸਿਰਜਣਾ ਦੌਰਾਨ ਵਰਤਿਆ ਗਿਆ seed ਮੁੱਲ।

ਹੋਰ ਮਾਡਲ: ਚਿੱਤਰ ਤੋਂ 3D

AI ਏਜੰਟਾਂ ਲਈ: ਇਹ ਪੰਨਾ Markdown ਵਜੋਂ ਇੱਥੇ ਹੈ https://doitong.com/pa/developers/models/hunyuan3d-v3/image-to-3d.md. ਸਾਰੇ ਮਾਡਲ ਅਤੇ ਗਾਈਡ: https://doitong.com/developers/llms.txt