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

Sam 3 · 3D Align

التكامل

معرّف النموذج 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
أفلت ملفًا، أو

عنوان URL للصورة المصدر لتقدير العمق باستخدام MoGe.

•مطلوب

عنوان URL للشبكة للمحاذاة، ويقبل ملف SAM-3D Body بصيغة .ply أو .glb.

متقدم body_mask_url · object_mesh_url · focal_length
أفلت ملفًا، أو

عنوان URL لصورة قناع البشر؛ يؤدي حذفه إلى استخدام الصورة بأكملها.

عنوان URL اختياري لشبكة SAM-3D Object بصيغة .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"

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

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

حول Sam 3 · 3D Align

يضع شبكة جسم بشري (.ply أو .glb) في الإحداثيات المكانية للصورة الأصلية، باستخدام تقدير العمق من `image_url`. تشمل المدخلات الاختيارية قناعًا بشريًا وقيمةً للبعد البؤري وشبكة كائن (.glb) تنتج ملف مشهد مركبًا. تتضمن المخرجات شبكات محاذاة بتنسيقي PLY وGLB وبيانات وصفية للمحاذاة وتمثيلًا مرئيًا تراكبيًا.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان URL للصورة المصدر لتقدير العمق باستخدام MoGe.
body_mesh_urlمطلوب
النوعstring
عنوان URL للشبكة للمحاذاة، ويقبل ملف SAM-3D Body بصيغة .ply أو .glb.
body_mask_urlاختياري
النوعurl · image
عنوان URL لصورة قناع البشر؛ يؤدي حذفه إلى استخدام الصورة بأكملها.
object_mesh_urlاختياري
النوعstring | null
عنوان URL اختياري لشبكة SAM-3D Object بصيغة .glb، يُستخدم لإنشاء مشهد مدمج.
focal_lengthاختياري
النوعnumber | null
تجاوز البعد البؤري المستمد من بيانات SAM-3D Body الوصفية، مع استخدام تقدير MoGe عند عدم توفير قيمة.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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}ملف 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} | nullمخرج GLB متاح فقط عند توفير object_mesh_url؛ ويحتوي على شبكتي الجسم والكائن معًا في مشهد واحد.

مزيد من النماذج: 3D

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