مواد پر جائیں

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

تیز تصویر سے 3D، ایک سامنے کے منظر کی تصویر سے ماڈل بناتا ہے، اختیاری PBR یا بغیر ٹیکسچر والی میش کے ساتھ

Tencent · 3D

آپ کا پہلا نتیجہ یہاں آئے گا

ذیل میں درخواست بنائیں اور اپنی API کلید کے ساتھ چلائیں۔ آؤٹ پٹس ہمارے اسٹوریج میں کاپی ہو جاتے ہیں، ہمیشہ کے لیے یا مفت میں 7 دن تک محفوظ رہتے ہیں۔

درخواست بنائیں

کنٹرولز ماڈل اسکیما سے تیار ہوتے ہیں۔ آپ کے بدلنے کے ساتھ کوڈ اور قیمت اپ ڈیٹ ہوتے ہیں۔

•لازمی
فائل ڈراپ کریں، یا

سامنے سے لی گئی تصویر URL کے ذریعے فراہم کریں؛ سادہ پس منظر اور فریم کے 50% سے زیادہ حصے کو بھرنے والی ایک شے تجویز کی جاتی ہے۔ JPG، PNG یا WEBP استعمال کریں، resolution 128 سے 5000px، فائل سائز کی حد 8 MB؛ base64 encoding کے لیے 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 کے بارے میں

ایک سامنے سے لی گئی تصویر (`input_image_url`، 128 سے 5000 px، زیادہ سے زیادہ 8MB، JPG، PNG یا WEBP) سے 3D ماڈل تخلیق کرتا ہے۔ سادہ پس منظر اور فریم کے نصف سے زیادہ حصے کو بھرنے والی ایک شے کے ساتھ بہترین کام کرتا ہے۔ `enable_pbr` دھاتی پن، کھردرا پن اور معمول کے ٹیکسچرز شامل کرتا ہے، جبکہ `enable_geometry` بغیر ٹیکسچر والا سفید ماڈل بطور GLB واپس کرتا ہے۔ آؤٹ پٹ میں ماڈل، ہر فارمیٹ کے URLs، ٹیکسچر، MTL فائل اور تھمب نیل شامل ہیں۔

پیرامیٹرز

نامقسم ڈیفالٹمجاز تفصیل
input_image_urlلازمی
قسمurl · image
سامنے سے لی گئی تصویر URL کے ذریعے فراہم کریں؛ سادہ پس منظر اور فریم کے 50% سے زیادہ حصے کو بھرنے والی ایک شے تجویز کی جاتی ہے۔ JPG، PNG یا WEBP استعمال کریں، resolution 128 سے 5000px، فائل سائز کی حد 8 MB؛ base64 encoding کے لیے 6 MB یا کم تجویز کیا جاتا ہے۔
enable_pbrاختیاری
قسمboolean
ڈیفالٹfalse
PBR تخلیق toggle، جب enable_geometry True ہو تو غیر فعال رہتا ہے۔ بصورت دیگر اسے فعال کرنے سے تخلیق کردہ materials میں metallic، roughness اور normal textures شامل ہو جاتے ہیں۔
enable_geometryاختیاری
قسمboolean
ڈیفالٹfalse
صرف geometry تخلیق کرنے کا toggle، جو OBJ سپورٹ غیر فعال کرتا ہے، آؤٹ پٹ کو ڈیفالٹ طور پر GLB بناتا ہے اور فعال ہونے پر enable_pbr کو نظرانداز کرتا ہے۔ نتیجے کا ماڈل سفید اور بغیر textures کے ہوتا ہے۔
لازمی

فائل پیرامیٹرز عوامی 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 ماڈل کے materials پر مشتمل MTL فائل۔
texture
object {url, content_type, file_name, file_size} | null3D ماڈل کا texture فراہم کرنے والی تصویر۔
thumbnail
object {url, content_type, file_name, file_size} | nullتخلیق کردہ ماڈل کا preview دکھانے والا thumbnail۔
model_urls
object {glb, fbx, obj, mtl, texture, usdz}مختلف formats میں 3D ماڈل کے links۔

مزید ماڈلز: تصویر سے 3D

AI ایجنٹس کے لیے: یہ صفحہ Markdown میں یہاں موجود ہے https://doitong.com/ur/developers/models/hunyuan-3d/v3.1/rapid/image-to-3d.md. تمام ماڈلز اور گائیڈز: https://doitong.com/developers/llms.txt