مواد پر جائیں

Sam 3 · 3D Body

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

ماڈل id sam-3/3d-body
# 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/sam-3/3d-body?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

API کلید حاصل کریں
Meta · 3D

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

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

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

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

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

انسانوں کو دکھانے والی تصویر کا URL۔

ایڈوانسڈ mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
فائل ڈراپ کریں، یا

اختیاری بائنری ماسک تصویر کا URL جو خودکار انسانی ڈیٹیکشن کی جگہ لے کر خودکار باؤنڈنگ باکس کے حساب کے لیے ڈیٹا فراہم کرتا ہے۔ شخص کو سفید اور پس منظر کو سیاہ رنگ میں انکوڈ کریں۔

POST /run/sam-3/3d-body?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.ru/v1/run/sam-3/3d-body?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

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

ایک تصویر میں موجود لوگوں کے 3D باڈی میشز بناتا ہے۔ لوگوں کی خودکار شناخت ہوتی ہے، یا آپ `mask_url` میں بائنری ماسک دے سکتے ہیں (شخص کے لیے سفید)۔ ٹوگلز فی شخص .ply ایکسپورٹ، GLB میں 3D کی پوائنٹ مارکرز، اور میٹاڈیٹا میں مکمل MHR پیرامیٹر سیٹ کو کنٹرول کرتے ہیں۔ GLB، میشز، میٹاڈیٹا اور ویژولائزیشن تصویر واپس کرتا ہے۔

پیرامیٹرز

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

نامقسم ڈیفالٹمجاز تفصیل
image_urlلازمی image
قسمurl · image
انسانوں کو دکھانے والی تصویر کا URL۔
mask_urlاختیاری mask
قسمurl · image
اختیاری بائنری ماسک تصویر کا URL جو خودکار انسانی ڈیٹیکشن کی جگہ لے کر خودکار باؤنڈنگ باکس کے حساب کے لیے ڈیٹا فراہم کرتا ہے۔ شخص کو سفید اور پس منظر کو سیاہ رنگ میں انکوڈ کریں۔
export_meshesاختیاری
قسمboolean
ڈیفالٹtrue
آیا ہر شخص کے لیے الگ .ply میش فائل برآمد کی جائے۔
include_3d_keypointsاختیاری
قسمboolean
ڈیفالٹtrue
آیا بصری نمائندگی کے لیے GLB میش میں کروی 3D کی پوائنٹ مارکرز شامل کیے جائیں۔
include_mhr_paramsاختیاری
قسمboolean
ڈیفالٹtrue
آیا ہر شخص کے جواب کے میٹا ڈیٹا میں مکمل MHR (Meta Human Representation) ڈیٹا شامل ہو یا صرف کیمرا پیرامیٹرز اور کی پوائنٹس (`false`)۔ مکمل ڈیٹا میں اظہار اور شکل، پوز اور خام پوز، جوائنٹ کوآرڈینیٹس اور عالمی گردشیں، نیز پیک کیے گئے ماڈل پیرامیٹرز شامل ہیں۔
لازمی معیاری نام، یہ بھی قبول ہے

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

آؤٹ پٹ

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/3d-body",
  "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": {
    "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
    },
    "meshes": [
      {
        "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": {
      "num_people": 1,
      "people": [
        {
          "person_id": 1,
          "bbox": [],
          "focal_length": 1.0,
          "pred_cam_t": [],
          "keypoints_2d": [],
          "keypoints_3d": [],
          "shape_params": [],
          "body_pose_params": [],
          "hand_pose_params": [],
          "global_rot": [],
          "pred_global_rots": [],
          "scale_params": [],
          "expr_params": [],
          "pred_joint_coords": [],
          "mhr_model_params": [],
          "pred_pose_raw": []
        }
      ],
      "keypoint_names": [
        "string"
      ]
    }
  },
  "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}GLB فارمیٹ کا 3D باڈی میش، اختیاری طور پر 3D کی پوائنٹس کے مارکرز سمیت۔
visualization
object {url, content_type, file_name, file_size}اصل تصویر، کی پوائنٹس، میش اور سائیڈ ویو دکھانے والی مرکب بصری نمائندگی۔
meshes
array of object {url, content_type, file_name, file_size} | nullہر شناخت شدہ شخص کے لیے الگ .ply میش فائلیں، export_meshes کے True ہونے پر واپس کی جاتی ہیں۔
metadata
object {num_people, people, keypoint_names}کیمرا پیرامیٹرز اور کی پوائنٹس پر مشتمل ساخت یافتہ میٹا ڈیٹا۔

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

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