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

Hunyuan 3D Rapid Image to 3D

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

ਮਾਡਲ id hunyuan-3d/v3.1/rapid/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/hunyuan-3d/v3.1/rapid/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.225 225 API ਕ੍ਰੈਡਿਟ · ≈ ₽24.18 ਇਸ ਪੰਨੇ ’ਤੇ ਚਲਾਓ

API ਕੁੰਜੀ ਲਵੋ
Tencent ਚਿੱਤਰ ਤੋਂ 3D #3d#hunyuan#image-to-3d

ਤੇਜ਼ image-to-3D, ਜੋ ਇੱਕ front-view ਚਿੱਤਰ ਤੋਂ ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ ਅਤੇ ਵਿਕਲਪਿਕ PBR ਜਾਂ ਬਿਨਾਂ-ਟੈਕਸਚਰ ਵਾਲੀ ਮੇਸ਼ ਦਿੰਦਾ ਹੈ

Tencent · 3D

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

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

ਰਿਕਵੈਸਟ ਬਣਾਓ

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

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

URL ਰਾਹੀਂ ਫਰੰਟ-ਵਿਊ ਚਿੱਤਰ ਦਿਓ; 50% ਤੋਂ ਵੱਧ ਫ੍ਰੇਮ ਕਵਰ ਕਰਨ ਵਾਲੀ ਇੱਕ ਵਸਤੂ ਸਮੇਤ ਸਧਾਰਣ ਬੈਕਗ੍ਰਾਊਂਡ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। 128 ਤੋਂ 5000px ਦੀ ਰੈਜ਼ੋਲਿਊਸ਼ਨ ਅਤੇ 8 MB ਦੀ ਫ਼ਾਈਲ-ਆਕਾਰ ਸੀਮਾ ਵਾਲਾ JPG, PNG ਜਾਂ WEBP ਵਰਤੋ; base64 ਐਨਕੋਡਿੰਗ ਲਈ 6 MB ਜਾਂ ਇਸ ਤੋਂ ਘੱਟ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ।

ਉੱਨਤ enable_geometry
POST /run/hunyuan-3d/v3.1/rapid/image-to-3d?wait=20 ਕੋਟ → $0.225
# 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/hunyuan-3d/v3.1/rapid/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 ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ

Hunyuan 3D Rapid Image to 3D ਬਾਰੇ

ਇੱਕ front-view ਚਿੱਤਰ (`input_image_url`, 128 ਤੋਂ 5000 px, ਵੱਧ ਤੋਂ ਵੱਧ 8MB, JPG, PNG ਜਾਂ WEBP) ਤੋਂ 3D ਮਾਡਲ ਬਣਾਉਂਦਾ ਹੈ। ਸਧਾਰਨ ਬੈਕਗ੍ਰਾਊਂਡ ਅਤੇ ਅੱਧੇ ਤੋਂ ਵੱਧ ਫ੍ਰੇਮ ਭਰਨ ਵਾਲੀ ਇੱਕ ਵਸਤੂ ਨਾਲ ਸਭ ਤੋਂ ਵਧੀਆ ਕੰਮ ਕਰਦਾ ਹੈ। `enable_pbr` ਮੈਟੈਲਿਕ, ਰਫ਼ਨੈੱਸ ਅਤੇ ਨਾਰਮਲ ਟੈਕਸਚਰ ਜੋੜਦਾ ਹੈ, ਜਦਕਿ `enable_geometry` ਬਿਨਾਂ-ਟੈਕਸਚਰ ਵਾਲਾ ਸਫ਼ੈਦ ਮਾਡਲ GLB ਵਜੋਂ ਵਾਪਸ ਕਰਦਾ ਹੈ। ਆਉਟਪੁੱਟ ਵਿੱਚ ਮਾਡਲ, ਹਰ ਫਾਰਮੈਟ ਲਈ URL, ਟੈਕਸਚਰ, MTL ਫ਼ਾਈਲ ਅਤੇ ਥੰਬਨੇਲ ਸ਼ਾਮਲ ਹਨ।

ਪੈਰਾਮੀਟਰ

ਨਾਮਕਿਸਮ ਡਿਫ਼ਾਲਟਮਨਜ਼ੂਰਸ਼ੁਦਾ ਵੇਰਵਾ
input_image_urlਲੋੜੀਂਦਾ
ਕਿਸਮurl · image
URL ਰਾਹੀਂ ਫਰੰਟ-ਵਿਊ ਚਿੱਤਰ ਦਿਓ; 50% ਤੋਂ ਵੱਧ ਫ੍ਰੇਮ ਕਵਰ ਕਰਨ ਵਾਲੀ ਇੱਕ ਵਸਤੂ ਸਮੇਤ ਸਧਾਰਣ ਬੈਕਗ੍ਰਾਊਂਡ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। 128 ਤੋਂ 5000px ਦੀ ਰੈਜ਼ੋਲਿਊਸ਼ਨ ਅਤੇ 8 MB ਦੀ ਫ਼ਾਈਲ-ਆਕਾਰ ਸੀਮਾ ਵਾਲਾ JPG, PNG ਜਾਂ WEBP ਵਰਤੋ; base64 ਐਨਕੋਡਿੰਗ ਲਈ 6 MB ਜਾਂ ਇਸ ਤੋਂ ਘੱਟ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ।
enable_pbrਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟfalse
PBR ਸਿਰਜਣਾ ਟੌਗਲ, ਜਦੋਂ enable_geometry True ਹੋਵੇ ਤਾਂ ਨਿਸ਼ਕ੍ਰਿਆ ਰਹਿੰਦਾ ਹੈ। ਨਹੀਂ ਤਾਂ ਇਸਨੂੰ ਚਾਲੂ ਕਰਨ ਨਾਲ ਸਿਰਜੇ ਗਏ ਮਟੀਰੀਅਲ ਵਿੱਚ ਮੈਟੈਲਿਕ, ਰਫ਼ਨੈੱਸ ਅਤੇ ਨਾਰਮਲ ਟੈਕਸਚਰ ਸ਼ਾਮਲ ਹੁੰਦੇ ਹਨ।
enable_geometryਵਿਕਲਪਿਕ
ਕਿਸਮboolean
ਡਿਫ਼ਾਲਟfalse
ਸਿਰਫ਼ ਜਿਓਮੈਟਰੀ ਵਾਲੀ ਸਿਰਜਣਾ ਦਾ ਟੌਗਲ, ਜੋ OBJ ਸਮਰਥਨ ਨੂੰ ਅਸਮਰੱਥ ਕਰਦਾ ਹੈ, ਆਉਟਪੁੱਟ ਨੂੰ GLB 'ਤੇ ਪੂਰਵ-ਨਿਰਧਾਰਤ ਕਰਦਾ ਹੈ ਅਤੇ ਚਾਲੂ ਹੋਣ 'ਤੇ enable_pbr ਨੂੰ ਨਜ਼ਰਅੰਦਾਜ਼ ਕਰਦਾ ਹੈ। ਨਤੀਜੇ ਵਾਲਾ ਮਾਡਲ ਸਫ਼ੈਦ ਹੁੰਦਾ ਹੈ ਅਤੇ ਇਸ ਵਿੱਚ ਕੋਈ ਟੈਕਸਚਰ ਨਹੀਂ ਹੁੰਦਾ।
ਲੋੜੀਂਦਾ

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

ਆਉਟਪੁੱਟ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/rapid/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": 225,
    "usd": "0.225",
    "charged": 225,
    "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
    },
    "material_mtl": {
      "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
    },
    "texture": {
      "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
      },
      "mtl": {
        "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
      },
      "texture": {
        "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
      }
    }
  },
  "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} | nullਸਿਰਜਿਆ ਗਿਆ 3D ਮਾਡਲ ਵਾਲੀ ਫ਼ਾਈਲ; ਉਪਲਬਧ ਹੋਣ 'ਤੇ GLB ਅਤੇ ਨਹੀਂ ਤਾਂ OBJ ਵਰਤੀ ਜਾਂਦੀ ਹੈ।
material_mtl
object {url, content_type, file_name, file_size} | nullOBJ ਮਾਡਲ ਲਈ ਮਟੀਰੀਅਲ ਵਾਲੀ MTL ਫ਼ਾਈਲ।
texture
object {url, content_type, file_name, file_size} | null3D ਮਾਡਲ ਦਾ ਟੈਕਸਚਰ ਦੇਣ ਵਾਲਾ ਚਿੱਤਰ।
thumbnail
object {url, content_type, file_name, file_size} | nullਸਿਰਜੇ ਗਏ ਮਾਡਲ ਦੀ ਝਲਕ ਦਿਖਾਉਣ ਵਾਲਾ ਥੰਬਨੇਲ।
model_urls
object {glb, fbx, obj, mtl, texture, usdz}ਵੱਖ-ਵੱਖ ਫਾਰਮੈਟਾਂ ਵਿੱਚ 3D ਮਾਡਲ ਦੇ ਲਿੰਕ।

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

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