דילוג לתוכן

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

בקשה זו: ≈⁨‏0.02 ‏$⁩ 20 קרדיטי API · ≈ ⁨‏2.11 ‏₽⁩ הרצה בדף הזה

קבלת מפתח 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.ru/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.ru/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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 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

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