مواد پر جائیں

Sam 3 · 3D Objects

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

ماڈل id sam-3/3d-objects
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sam-3/3d-objects?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

یہ درخواست: ≈⁨$0.02⁩ 20 API کریڈٹس اس صفحے پر چلائیں

API کلید حاصل کریں
Meta تصویر سے 3D #3d#object

تصویر سے 3D آبجیکٹس بناتا ہے، جنہیں متن، پوائنٹ یا باکس پرامپٹس یا ماسکس سے منتخب کیا جاتا ہے، اور splat آؤٹ پٹ فراہم کرتا ہے

Meta · 3D

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

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

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

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

ڈیفالٹ car

ماسکس موجود نہ ہونے پر خودکار سیگمنٹیشن کے لیے استعمال ہونے والا متن، جیسے 'chair' یا 'lamp'۔

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

3D تعمیر نو کے لیے تصویر کا URL۔

ایڈوانسڈ mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
فائل ڈراپ کریں، یا

اختیاری فی آبجیکٹ ماسک URL فہرست۔ ماسکس کے بغیر، فراہم ہونے کی صورت میں خودکار سیگمنٹیشن پرامپٹ، point_prompts یا box_prompts استعمال کرتی ہے؛ اگر ماسکس یا سیگمنٹیشن پرامپٹس میں سے کوئی بھی فراہم نہ ہو تو پوری تصویر استعمال ہوتی ہے۔

NPY یا NPZ کے طور پر بیرونی pointmap یا depth ڈیٹا فراہم کرکے 3D تعمیر نو میں گہرائی کے تخمینے کو بہتر بنانے کے لیے اختیاری URL۔

ڈیٹیکشن اعتماد کی حد؛ نہ دینے پر ماڈل کا ڈیفالٹ استعمال ہوتا ہے۔ قدریں 0.1 سے 1.0 تک ہیں، اور کم قدریں زیادہ ڈیٹیکشنز کے لیے درستگی میں کمی کا تبادلہ کرتی ہیں۔

قابل تکرار تصادفی تخلیق کے لیے استعمال ہونے والا seed۔

ڈیفالٹ []

ماسکس موجود نہ ہونے پر خودکار سیگمنٹیشن کے لیے استعمال ہونے والے پوائنٹ پر مبنی پرامپٹس۔

ڈیفالٹ []

باکس پرامپٹس جو خودکار سیگمنٹیشن کے ذریعے 3D تعمیر نو کے لیے انفرادی آبجیکٹ ماسکس تیار کرتے ہیں؛ صرف اس وقت استعمال ہوتے ہیں جب ماسکس فراہم نہ کیے گئے ہوں۔ متعدد باکس جمع کرائے جا سکتے ہیں۔

POST /run/sam-3/3d-objects?wait=20 قیمت → ⁨$0.02⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sam-3/3d-objects?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

یہ درخواست چلائیں

آپ کی key اسی براؤزر میں رہتی ہے: یہ صرف Doitong API کو بھیجی جاتی ہے اور صرف اس صورت میں localStorage میں محفوظ ہوتی ہے جب آپ Remember منتخب کریں۔ API کلید حاصل کریں

Sam 3 · 3D Objects کے بارے میں

تصویر میں موجود آبجیکٹس کو 3D اثاثوں میں تبدیل کرتا ہے۔ آبجیکٹس `mask_urls`، متنی `prompt`، `point_prompts` یا `box_prompts` سے منتخب کریں؛ متعدد باکسز الگ آبجیکٹس بناتے ہیں۔ `detection_threshold` 0.1 سے 1 قبول کرتا ہے، جبکہ `export_textured_glb` ٹیکسچر اور UVs کو شامل کرتا ہے۔ GLB، Gaussian splat فائلز، متعدد آبجیکٹس والے مناظر کے لیے فی آبجیکٹ فائلز، میٹا ڈیٹا اور zip بنڈل آؤٹ پٹ کرتا ہے۔

پیرامیٹرز

معیاری نام یا مقامی نام میں سے صرف ایک بھیجیں، دونوں نہیں۔ معیاری نام

نامقسم ڈیفالٹمجاز تفصیل
image_urlلازمی image
قسمurl · image
3D تعمیر نو کے لیے تصویر کا URL۔
mask_urlsاختیاری
قسمurl[] · image
اختیاری فی آبجیکٹ ماسک URL فہرست۔ ماسکس کے بغیر، فراہم ہونے کی صورت میں خودکار سیگمنٹیشن پرامپٹ، point_prompts یا box_prompts استعمال کرتی ہے؛ اگر ماسکس یا سیگمنٹیشن پرامپٹس میں سے کوئی بھی فراہم نہ ہو تو پوری تصویر استعمال ہوتی ہے۔
promptاختیاری
قسمstring | null
ڈیفالٹcar
ماسکس موجود نہ ہونے پر خودکار سیگمنٹیشن کے لیے استعمال ہونے والا متن، جیسے 'chair' یا 'lamp'۔
point_promptsاختیاری
قسمobject[]
ڈیفالٹ[]
ماسکس موجود نہ ہونے پر خودکار سیگمنٹیشن کے لیے استعمال ہونے والے پوائنٹ پر مبنی پرامپٹس۔
point_prompts[].xاختیاری
قسمinteger | null
X محور پر پرامپٹ کی پوزیشن۔
point_prompts[].yاختیاری
قسمinteger | null
Y محور پر پرامپٹ کی پوزیشن۔
point_prompts[].labelاختیاری
قسمenum
01
پیش منظر/پس منظر کا لیبل: 1 پیش منظر اور 0 پس منظر ظاہر کرتا ہے۔
point_prompts[].object_idاختیاری
قسمinteger | null
ایک آبجیکٹ کو بہتر بنانے والے پرامپٹس کو گروپ کرنے کے لیے اختیاری شناخت کنندہ۔ اگر متن بھی پرامپٹ کے طور پر فراہم کیا جائے تو یہ شناخت کنندہ طے کرتا ہے کہ دریافت شدہ کون سا آبجیکٹ ان نقاط سے بہتر کیا جائے۔
box_promptsاختیاری
قسمobject[]
ڈیفالٹ[]
باکس پرامپٹس جو خودکار سیگمنٹیشن کے ذریعے 3D تعمیر نو کے لیے انفرادی آبجیکٹ ماسکس تیار کرتے ہیں؛ صرف اس وقت استعمال ہوتے ہیں جب ماسکس فراہم نہ کیے گئے ہوں۔ متعدد باکس جمع کرائے جا سکتے ہیں۔
box_prompts[].x_minاختیاری
قسمinteger | null
باکس کے لیے کم از کم x-coordinate۔
box_prompts[].y_minاختیاری
قسمinteger | null
باکس کے لیے کم از کم y-coordinate۔
box_prompts[].x_maxاختیاری
قسمinteger | null
باکس کے لیے زیادہ سے زیادہ X coordinate۔
box_prompts[].y_maxاختیاری
قسمinteger | null
باکس کے لیے زیادہ سے زیادہ Y coordinate۔
box_prompts[].object_idاختیاری
قسمinteger | null
ایک آبجیکٹ کو بہتر بنانے والے باکسز کو گروپ کرنے کے لیے اختیاری شناخت کنندہ۔
seedاختیاری
قسمinteger | null
قابل تکرار تصادفی تخلیق کے لیے استعمال ہونے والا seed۔
pointmap_urlاختیاری
قسمstring | null
NPY یا NPZ کے طور پر بیرونی pointmap یا depth ڈیٹا فراہم کرکے 3D تعمیر نو میں گہرائی کے تخمینے کو بہتر بنانے کے لیے اختیاری URL۔
detection_thresholdاختیاری
قسمnumber | null
0.1 – 1
ڈیٹیکشن اعتماد کی حد؛ نہ دینے پر ماڈل کا ڈیفالٹ استعمال ہوتا ہے۔ قدریں 0.1 سے 1.0 تک ہیں، اور کم قدریں زیادہ ڈیٹیکشنز کے لیے درستگی میں کمی کا تبادلہ کرتی ہیں۔
export_textured_glbاختیاری
قسمboolean
ڈیفالٹfalse
GLB برآمد کا انتخاب: یہ آپشن فعال کرنے سے vertex colors کی جگہ baked texture اور UVs استعمال ہوتے ہیں۔
لازمی معیاری نام، یہ بھی قبول ہے

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

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/3d-objects",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "gaussian_splat": {
      "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_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
    },
    "metadata": [
      {
        "object_index": 1,
        "scale": [
          []
        ],
        "rotation": [
          []
        ],
        "translation": [
          []
        ],
        "camera_pose": [
          []
        ]
      }
    ],
    "individual_splats": [
      {
        "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
      }
    ],
    "individual_glbs": [
      {
        "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
      }
    ],
    "artifacts_zip": {
      "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
آپ کی فائلیں، آپ کا انتخابہر outputs[].url ہمارے اسٹوریج میں ایک کاپی ہے: ہمیشہ کے لیے محفوظ (فی GB-ماہ ادائیگی) یا مفت میں 7 دن تک، آپ کی اکاؤنٹ سیٹنگ یا ?storage= کے مطابق۔
ہر ماڈل میں ایک جیسی ساختtype، url، content_type، width، height اور duration، تصاویر، ویڈیو اور آڈیو سب کے لیے یکساں۔ output ماڈل کا اپنا نتیجہ آبجیکٹ ہے۔
آؤٹ پٹ کے فیلڈز
gaussian_splat
object {url, content_type, file_name, file_size}متعدد آبجیکٹس والے نتائج کے لیے مشترکہ منظر کا splat، یا بصورت دیگر واحد splat؛ .ply فارمیٹ میں Gaussian splat فائل کے طور پر فراہم کیا جاتا ہے۔
model_glb
object {url, content_type, file_name, file_size}GLB کے طور پر محفوظ 3D آؤٹ پٹ: متعدد آبجیکٹس کو ایک منظر میں جوڑا جاتا ہے، جبکہ دیگر نتائج میں ایک میش ہوتا ہے۔
metadata
array of object {object_index, scale, rotation, translation, camera_pose}ہر آبجیکٹ کا میٹا ڈیٹا، جس میں گردش، ترجمہ اور اسکیل شامل ہیں۔
individual_splats
array of object {url, content_type, file_name, file_size} | nullہر آبجیکٹ کے لیے الگ Gaussian splat فائلیں، صرف متعدد آبجیکٹس والے مناظر میں دستیاب ہیں۔
individual_glbs
array of object {url, content_type, file_name, file_size} | nullہر آبجیکٹ کے لیے الگ GLB میش فائلیں، صرف متعدد آبجیکٹس والے مناظر میں دستیاب ہیں۔
artifacts_zip
object {url, content_type, file_name, file_size} | nullتمام artifacts اور میٹا ڈیٹا کا ZIP آرکائیو۔

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

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