تخطّي إلى المحتوى

Sam 3 · 3D Body

التكامل

معرّف النموذج 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ≈⁨‏0.02 $⁩ 20 رصيد API تشغيله في هذه الصفحة

الحصول على مفتاح API
Meta من صورة إلى 3D #3d#human#pose

يعيد بناء شبكات أجسام بشرية ثلاثية الأبعاد من صورة واحدة، شبكة واحدة لكل شخص مكتشف

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Sam 3 · 3D Body

ينشئ شبكات ثلاثية الأبعاد لأجسام الأشخاص في صورة واحدة. تُكتشف الأشخاص تلقائيًا، أو يمكنك تمرير قناع ثنائي في `mask_url` (أبيض للشخص). تتحكم المفاتيح في تصدير .ply لكل شخص، وعلامات النقاط المفتاحية ثلاثية الأبعاد في GLB، ومجموعة معلمات 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 لأغراض التصوير البصري.
include_mhr_paramsاختياري
النوعboolean
الافتراضيtrue
ما إذا كانت البيانات الوصفية لاستجابة كل شخص تتضمن بيانات MHR (Meta Human Representation) كاملة أو معلمات الكاميرا ونقاط المفاتيح فقط (`false`). تغطي البيانات الكاملة التعبير والشكل والوضعية والوضعية الخام وإحداثيات المفاصل والدورانات العامة، إضافةً إلى معلمات النموذج المعبأة.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو 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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
model_glb
object {url, content_type, file_name, file_size}شبكة جسم ثلاثية الأبعاد بصيغة GLB، وقد تتضمن علامات لنقاط المفاتيح ثلاثية الأبعاد.
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

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/sam-3/3d-body.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt