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

Sam 3 · 3D Objects

التكامل

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

يعيد بناء كائنات ثلاثية الأبعاد من صورة، مع تحديدها بمطالبات نصية أو نقطية أو مربعية أو أقنعة، وإخراج splat

Meta · 3D

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

الافتراضي car

نص يُستخدم للتقسيم التلقائي عند غياب الأقنعة، مثل 'chair' أو 'lamp'.

•مطلوب image_url
أفلت ملفًا، أو

عنوان URL للصورة لإعادة البناء ثلاثي الأبعاد.

متقدم mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
أفلت ملفًا، أو

قائمة اختيارية بعناوين URL لأقنعة كل كائن. من دون الأقنعة، يستخدم التقسيم التلقائي موجّه أو point_prompts أو box_prompts عند توفيرها؛ وإذا لم تُوفَّر الأقنعة أو موجّهات التقسيم، تُستخدم الصورة بأكملها.

عنوان URL اختياري لتحسين تقدير العمق في إعادة البناء ثلاثي الأبعاد عبر توفير بيانات pointmap أو depth خارجية بصيغة NPY أو NPZ.

حدّ الثقة للكشف، ويُترك على القيمة الافتراضية للنموذج عند حذفه. تتراوح القيم بين 0.1 و1.0، وتستبدل القيم الأصغر الدقة بزيادة عدد عمليات الكشف.

البذرة المستخدمة للتوليد العشوائي القابل لإعادة الإنتاج.

الافتراضي []

موجّهات قائمة على النقاط تُستخدم للتقسيم التلقائي عند غياب الأقنعة.

الافتراضي []

موجّهات مربعات تنتج أقنعة فردية للكائنات لإعادة البناء ثلاثي الأبعاد عبر التقسيم التلقائي، وتُستخدم فقط عند عدم توفير الأقنعة. يمكن إرسال عدة مربعات.

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"

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

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

حول Sam 3 · 3D Objects

يحوّل الكائنات في صورة إلى أصول ثلاثية الأبعاد. اختر الكائنات باستخدام `mask_urls` أو مطالبة نصية `prompt` أو `point_prompts` أو `box_prompts`؛ وتنتج المربعات المتعددة كائنات منفصلة. يقبل `detection_threshold` القيم من 0.1 إلى 1، ويضمّن `export_textured_glb` النسيج وإحداثيات UV. تتضمن المخرجات GLB وملفات Gaussian splat وملفات لكل كائن في المشاهد متعددة الكائنات وبيانات وصفية وحزمة zip.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
image_urlمطلوب image
النوعurl · image
عنوان 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[]
الافتراضي[]
موجّهات مربعات تنتج أقنعة فردية للكائنات لإعادة البناء ثلاثي الأبعاد عبر التقسيم التلقائي، وتُستخدم فقط عند عدم توفير الأقنعة. يمكن إرسال عدة مربعات.
box_prompts[].x_minاختياري
النوعinteger | null
الحد الأدنى لإحداثي x للصندوق.
box_prompts[].y_minاختياري
النوعinteger | null
الحد الأدنى لإحداثي y للصندوق.
box_prompts[].x_maxاختياري
النوعinteger | null
إحداثي X الأقصى للمربع.
box_prompts[].y_maxاختياري
النوعinteger | null
إحداثي Y الأقصى للمربع.
box_prompts[].object_idاختياري
النوعinteger | null
معرّف اختياري لتجميع المربعات التي تحسّن كائنًا واحدًا.
seedاختياري
النوعinteger | null
البذرة المستخدمة للتوليد العشوائي القابل لإعادة الإنتاج.
pointmap_urlاختياري
النوعstring | null
عنوان URL اختياري لتحسين تقدير العمق في إعادة البناء ثلاثي الأبعاد عبر توفير بيانات pointmap أو depth خارجية بصيغة NPY أو NPZ.
detection_thresholdاختياري
النوعnumber | null
0.1 – 1
حدّ الثقة للكشف، ويُترك على القيمة الافتراضية للنموذج عند حذفه. تتراوح القيم بين 0.1 و1.0، وتستبدل القيم الأصغر الدقة بزيادة عدد عمليات الكشف.
export_textured_glbاختياري
النوعboolean
الافتراضيfalse
خيار تصدير GLB: يؤدي تمكين هذا الخيار إلى استبدال ألوان الرؤوس بخامة مخبوزة وإحداثيات UV.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو 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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
gaussian_splat
object {url, content_type, file_name, file_size}تناثر مشهد مدمج للنتائج ذات الكائنات المتعددة، أو تناثر واحد بخلاف ذلك؛ يُقدَّم كملف Gaussian splat بصيغة .ply.
model_glb
object {url, content_type, file_name, file_size}مخرج ثلاثي الأبعاد محفوظ بصيغة GLB: تُجمع الكائنات المتعددة في مشهد واحد، بينما تحتوي النتائج الأخرى على شبكة واحدة.
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أرشيف ZIP لجميع العناصر والبيانات الوصفية.

مزيد من النماذج: من صورة إلى 3D

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