Μετάβαση στο περιεχόμενο

Sam 3 · 3D Body

Ενσωμάτωση

id μοντέλου 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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Αυτό το αίτημα: ≈0,02 $ 20 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού 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.com/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.com/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
Αν θα εξαχθεί ξεχωριστό αρχείο mesh .ply για κάθε άτομο.
include_3d_keypointsπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Αν θα προστεθούν σφαιρικοί δείκτες τρισδιάστατων σημείων-κλειδιών στο mesh 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.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 είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
model_glb
object {url, content_type, file_name, file_size}Τρισδιάστατο mesh σώματος σε μορφή GLB, προαιρετικά με δείκτες για τρισδιάστατα σημεία-κλειδιά.
visualization
object {url, content_type, file_name, file_size}Σύνθετη οπτικοποίηση που εμφανίζει την αρχική εικόνα, τα σημεία-κλειδιά, το mesh και την πλευρική όψη.
meshes
array of object {url, content_type, file_name, file_size} | nullΞεχωριστά αρχεία mesh .ply για κάθε ανιχνευμένο άτομο, τα οποία επιστρέφονται όταν το export_meshes είναι True.
metadata
object {num_people, people, keypoint_names}Δομημένα μεταδεδομένα που περιέχουν παραμέτρους κάμερας και σημεία-κλειδιά.

Περισσότερα μοντέλα: Εικόνα σε 3D

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/sam-3/3d-body.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt