مواد پر جائیں

Hunyuan 3D Pro Image to 3D

انٹیگریٹ کریں

ماڈل id hunyuan-3d/v3.1/pro/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/pro/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.30⁩ آپ کی فائلیں رن سے پہلے ناپی جاتی ہیں اس صفحے پر چلائیں

API کلید حاصل کریں
Tencent تصویر سے 3D #3d#hunyuan#image-to-3d

سامنے کی تصویر اور اختیاری اضافی مناظر سے 3D ماڈل بناتا ہے، face count اور PBR کنٹرول کے ساتھ

Tencent · 3D

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

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

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

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

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

سامنے سے لی گئی JPG، PNG یا WEBP تصویر کا URL، جس کی resolution 128 سے 5000px اور سائز زیادہ سے زیادہ 8 MB ہو۔ سادہ پس منظر اور فریم کے 50% سے زیادہ حصے کو بھرنے والی ایک شے کو ترجیح دیں۔

فائل ڈراپ کریں، یا

پیچھے سے لی گئی تصویر کا URL، اختیاری؛ JPG/PNG تجویز کیا جاتا ہے۔

فائل ڈراپ کریں، یا

بائیں جانب کی تصویر کا URL، اختیاری؛ JPG/PNG تجویز کیا جاتا ہے۔

فائل ڈراپ کریں، یا

دائیں جانب کی تصویر کا URL، اختیاری؛ JPG/PNG تجویز کیا جاتا ہے۔

فائل ڈراپ کریں، یا

اوپر سے لی گئی تصویر کا URL، اختیاری اور صرف v3.1 میں دستیاب؛ JPG/PNG تجویز کیا جاتا ہے۔

فائل ڈراپ کریں، یا

نیچے سے لی گئی اختیاری تصویر کا URL، صرف v3.1 میں سپورٹڈ۔ JPG/PNG تجویز کیا جاتا ہے۔

فائل ڈراپ کریں، یا

اختیاری تصویر URL، صرف v3.1 میں دستیاب، ترجیحاً JPG/PNG format میں۔ تصویر بائیں سامنے سے 45-degree view فراہم کرتی ہے۔

فائل ڈراپ کریں، یا

اختیاری تصویر URL، صرف v3.1 میں دستیاب، ترجیحاً JPG/PNG format میں۔ تصویر دائیں سامنے سے 45-degree view فراہم کرتی ہے۔

ڈیفالٹ 500000

polygon faces کی مطلوبہ تعداد، 40,000 سے 1,500,000 تک۔ ڈیفالٹ 500,000 ہے۔

ایڈوانسڈ generate_type
generate_type ڈیفالٹ Normal

Normal کے ساتھ textured ماڈل اور Geometry کے ساتھ untextured سفید، صرف geometry والا ماڈل منتخب کریں۔ v3.1 میں LowPoly/Sketch منتخب نہیں کیے جا سکتے۔

POST /run/hunyuan-3d/v3.1/pro/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/hunyuan-3d/v3.1/pro/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 Pro Image to 3D کے بارے میں

لازمی سامنے کی تصویر، `input_image_url`، سے 3D ماڈل بناتا ہے۔ اختیاری پشت، بائیں، دائیں، اوپر، نیچے اور دو 45-degree زاویوں کے مناظر مزید تفصیل شامل کر سکتے ہیں۔ `generate_type` ٹیکسچر والے ماڈل یا صرف سفید جیومیٹری کا انتخاب کرتا ہے، `enable_pbr` PBR مواد شامل کرتا ہے، اور `face_count` 40,000 سے 1,500,000 تک ہے۔ GLB، دیگر فارمیٹس کے URLs اور تھمب نیل واپس کرتا ہے۔

پیرامیٹرز

نامقسم ڈیفالٹمجاز تفصیل
input_image_urlلازمی
قسمurl · image
سامنے سے لی گئی JPG، PNG یا WEBP تصویر کا URL، جس کی resolution 128 سے 5000px اور سائز زیادہ سے زیادہ 8 MB ہو۔ سادہ پس منظر اور فریم کے 50% سے زیادہ حصے کو بھرنے والی ایک شے کو ترجیح دیں۔
back_image_urlاختیاری
قسمurl · image
پیچھے سے لی گئی تصویر کا URL، اختیاری؛ JPG/PNG تجویز کیا جاتا ہے۔
left_image_urlاختیاری
قسمurl · image
بائیں جانب کی تصویر کا URL، اختیاری؛ JPG/PNG تجویز کیا جاتا ہے۔
right_image_urlاختیاری
قسمurl · image
دائیں جانب کی تصویر کا URL، اختیاری؛ JPG/PNG تجویز کیا جاتا ہے۔
top_image_urlاختیاری
قسمurl · image
اوپر سے لی گئی تصویر کا URL، اختیاری اور صرف v3.1 میں دستیاب؛ JPG/PNG تجویز کیا جاتا ہے۔
bottom_image_urlاختیاری
قسمurl · image
نیچے سے لی گئی اختیاری تصویر کا URL، صرف v3.1 میں سپورٹڈ۔ JPG/PNG تجویز کیا جاتا ہے۔
left_front_image_urlاختیاری
قسمurl · image
اختیاری تصویر URL، صرف v3.1 میں دستیاب، ترجیحاً JPG/PNG format میں۔ تصویر بائیں سامنے سے 45-degree view فراہم کرتی ہے۔
right_front_image_urlاختیاری
قسمurl · image
اختیاری تصویر URL، صرف v3.1 میں دستیاب، ترجیحاً JPG/PNG format میں۔ تصویر دائیں سامنے سے 45-degree view فراہم کرتی ہے۔
generate_typeاختیاری
قسمenum
ڈیفالٹNormal
NormalGeometry
Normal کے ساتھ textured ماڈل اور Geometry کے ساتھ untextured سفید، صرف geometry والا ماڈل منتخب کریں۔ v3.1 میں LowPoly/Sketch منتخب نہیں کیے جا سکتے۔
enable_pbrاختیاری
قسمboolean
ڈیفالٹfalse
PBR تخلیق toggle، جب generate_type Geometry ہو تو غیر فعال رہتا ہے۔ بصورت دیگر اسے فعال کرنے سے تخلیق کردہ materials میں metallic، roughness اور normal textures شامل ہو جاتے ہیں۔
face_countاختیاری
قسمinteger
ڈیفالٹ500000
40,000 – 1,500,000
polygon faces کی مطلوبہ تعداد، 40,000 سے 1,500,000 تک۔ ڈیفالٹ 500,000 ہے۔
لازمی

فائل پیرامیٹرز عوامی https:// URL، 10 MB تک کی data: URI، یا اپ لوڈ کے file_url کو قبول کرتے ہیں۔ فائلیں

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hunyuan-3d/v3.1/pro/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
      },
      "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
      }
    },
    "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 object پر مشتمل GLB فائل۔
thumbnail
object {url, content_type, file_name, file_size} | nullتخلیق کردہ ماڈل کا preview دکھانے والا thumbnail۔
model_urls
object {glb, fbx, obj, mtl, texture, usdz}مختلف formats میں 3D ماڈل کے links۔
seed
integer | nullتخلیق کے دوران استعمال ہونے والی سیڈ قدر۔

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

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