דילוג לתוכן

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 הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 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

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