مواد پر جائیں

Sam 3 · 3D Align

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

ماڈل id sam-3/3d-align
# 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-align?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",
    "body_mesh_url": "https://example.com/your-file.glb"
  }'

# 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 #align#3d

SAM 3D باڈی میش کو ماخذ تصویر کے منظر کے ساتھ ہم آہنگ کرتا ہے، اور اختیاری طور پر اسے آبجیکٹ میش کے ساتھ ملاتا ہے

Meta · 3D

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

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

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

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

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

MoGe کے ساتھ گہرائی کے تخمینے کے لیے ماخذ تصویر کا URL۔

•لازمی

الائنمنٹ کے لیے میش URL، جو .ply یا .glb فارمیٹ میں SAM-3D Body فائل قبول کرتا ہے۔

ایڈوانسڈ body_mask_url · object_mesh_url · focal_length
فائل ڈراپ کریں، یا

انسانی ماسک تصویر کا URL؛ اسے چھوڑنے پر پوری تصویر استعمال ہوتی ہے۔

SAM-3D Object کے لیے اختیاری میش URL، .glb فارمیٹ میں، مشترکہ منظر بنانے کے لیے استعمال ہوتا ہے۔

SAM-3D Body میٹا ڈیٹا سے حاصل کردہ فوکل لینتھ اووررائڈ؛ قدر نہ دینے پر MoGe کا تخمینہ استعمال ہوتا ہے۔

POST /run/sam-3/3d-align?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-align?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",
    "body_mesh_url": "https://example.com/your-file.glb"
  }'

# 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 Align کے بارے میں

انسانی جسم کے میش (.ply یا .glb) کو اصل تصویر کے کوآرڈینیٹ اسپیس میں رکھتا ہے، جس کے لیے `image_url` سے گہرائی کا تخمینہ استعمال کیا جاتا ہے۔ اختیاری ان پٹس میں انسانی ماسک، فوکل لینتھ کی قدر، اور آبجیکٹ میش (.glb) شامل ہیں، جس سے مشترکہ سین فائل بنتی ہے۔ آؤٹ پٹس میں PLY اور GLB میں الائن کیے گئے میشز، الائنمنٹ میٹاڈیٹا اور اوورلے ویژولائزیشن شامل ہیں۔

پیرامیٹرز

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

نامقسم ڈیفالٹمجاز تفصیل
image_urlلازمی image
قسمurl · image
MoGe کے ساتھ گہرائی کے تخمینے کے لیے ماخذ تصویر کا URL۔
body_mesh_urlلازمی
قسمstring
الائنمنٹ کے لیے میش URL، جو .ply یا .glb فارمیٹ میں SAM-3D Body فائل قبول کرتا ہے۔
body_mask_urlاختیاری
قسمurl · image
انسانی ماسک تصویر کا URL؛ اسے چھوڑنے پر پوری تصویر استعمال ہوتی ہے۔
object_mesh_urlاختیاری
قسمstring | null
SAM-3D Object کے لیے اختیاری میش URL، .glb فارمیٹ میں، مشترکہ منظر بنانے کے لیے استعمال ہوتا ہے۔
focal_lengthاختیاری
قسمnumber | null
SAM-3D Body میٹا ڈیٹا سے حاصل کردہ فوکل لینتھ اووررائڈ؛ قدر نہ دینے پر MoGe کا تخمینہ استعمال ہوتا ہے۔
لازمی معیاری نام، یہ بھی قبول ہے

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

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/3d-align",
  "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",
    "body_mesh_url": "https://example.com/your-file.glb"
  },
  "output": {
    "body_mesh_ply": {
      "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
    },
    "visualization": {
      "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": {
      "person_id": 1,
      "scale_factor": 1.0,
      "translation": [
        1.0
      ],
      "focal_length": 1.0,
      "target_points_count": 1,
      "cropped_vertices_count": 1
    },
    "scene_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
    }
  },
  "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 ماڈل کا اپنا نتیجہ آبجیکٹ ہے۔
آؤٹ پٹ کے فیلڈز
body_mesh_ply
object {url, content_type, file_name, file_size}الائن کیے گئے باڈی میش پر مشتمل PLY فائل۔
model_glb
object {url, content_type, file_name, file_size}3D پیش منظر کے لیے الائن کیے گئے باڈی میش پر مشتمل GLB فائل۔
visualization
object {url, content_type, file_name, file_size}الائن کیے گئے میش کے اوپر دکھائی گئی ان پٹ تصویر کی بصری نمائندگی۔
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}الائنمنٹ کی تفصیلات، جیسے اسکیل اور ترجمہ۔
scene_glb
object {url, content_type, file_name, file_size} | nullGLB آؤٹ پٹ صرف object_mesh_url فراہم ہونے پر دستیاب ہے؛ اس میں ایک ہی منظر میں باڈی اور آبجیکٹ دونوں میش شامل ہوتے ہیں۔

مزید ماڈلز: 3D

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