דילוג לתוכן

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 או עומק חיצוניים בפורמט NPY או NPZ.

סף הביטחון לזיהוי; אם לא צוין, נעשה שימוש בברירת המחדל של המודל. הערכים נעים בין 0.1 ל-1.0, כאשר ערכים נמוכים יותר מפחיתים את הדיוק לטובת מספר זיהויים גדול יותר.

Seed המשמש ליצירה אקראית הניתנת לשחזור.

ברירת מחדל []

הנחיות המבוססות על נקודות לפילוח אוטומטי כאשר אין מסכות.

ברירת מחדל []

הנחיות תיבה המפיקות מסכות נפרדות לאובייקטים עבור שחזור תלת-ממדי באמצעות פילוח אוטומטי, ומשמשות רק כאשר לא סופקו מסכות. ניתן לשלוח כמה תיבות.

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
Seed המשמש ליצירה אקראית הניתנת לשחזור.
pointmap_urlאופציונלי
סוגstring | null
כתובת URL אופציונלית לשיפור הערכת העומק בשחזור תלת-ממדי באמצעות נתוני pointmap או עומק חיצוניים בפורמט NPY או NPZ.
detection_thresholdאופציונלי
סוגnumber | null
0.1 – 1
סף הביטחון לזיהוי; אם לא צוין, נעשה שימוש בברירת המחדל של המודל. הערכים נעים בין 0.1 ל-1.0, כאשר ערכים נמוכים יותר מפחיתים את הדיוק לטובת מספר זיהויים גדול יותר.
export_textured_glbאופציונלי
סוגboolean
ברירת מחדלfalse
אפשרות ייצוא GLB: הפעלת אפשרות זו מחליפה את צבעי הקודקודים בטקסטורה אפויה וב-UVs.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים 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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
gaussian_splat
object {url, content_type, file_name, file_size}Splat של סצנה משולבת עבור תוצאות עם כמה אובייקטים, או Splat יחיד אחרת; מסופק כקובץ 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

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/sam-3/3d-objects.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt