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

Sam 3 · 3D Objects

Ενσωμάτωση

id μοντέλου 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 μασκών ανά αντικείμενο. Χωρίς μάσκες, η αυτόματη τμηματοποίηση χρησιμοποιεί τα prompt, point_prompts ή box_prompts, αν παρέχονται· αν δεν παρέχονται ούτε μάσκες ούτε prompt τμηματοποίησης, χρησιμοποιείται ολόκληρη η εικόνα.

Προαιρετικό URL για βελτίωση της εκτίμησης βάθους στην τρισδιάστατη ανακατασκευή, με παροχή εξωτερικών δεδομένων pointmap ή βάθους ως NPY ή NPZ.

Όριο εμπιστοσύνης ανίχνευσης, με χρήση της προεπιλογής του μοντέλου αν παραλειφθεί. Οι τιμές κυμαίνονται από 0.1 έως 1.0, με τις μικρότερες τιμές να ανταλλάσσουν ακρίβεια με αυξημένο αριθμό ανιχνεύσεων.

Seed που χρησιμοποιείται για αναπαραγώγιμη τυχαία παραγωγή.

προεπιλογή []

Prompt βάσει σημείων για αυτόματη τμηματοποίηση όταν απουσιάζουν μάσκες.

προεπιλογή []

Box prompt που παράγουν μεμονωμένες μάσκες αντικειμένων για τρισδιάστατη ανακατασκευή μέσω αυτόματης τμηματοποίησης και χρησιμοποιούνται μόνο όταν δεν παρέχονται μάσκες. Μπορούν να υποβληθούν πολλά πλαίσια.

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 μασκών ανά αντικείμενο. Χωρίς μάσκες, η αυτόματη τμηματοποίηση χρησιμοποιεί τα prompt, point_prompts ή box_prompts, αν παρέχονται· αν δεν παρέχονται ούτε μάσκες ούτε prompt τμηματοποίησης, χρησιμοποιείται ολόκληρη η εικόνα.
promptπροαιρετικό
Τύποςstring | null
Προεπιλογήcar
Κείμενο που χρησιμοποιείται για αυτόματη τμηματοποίηση όταν απουσιάζουν μάσκες, όπως 'chair' ή 'lamp'.
point_promptsπροαιρετικό
Τύποςobject[]
Προεπιλογή[]
Prompt βάσει σημείων για αυτόματη τμηματοποίηση όταν απουσιάζουν μάσκες.
point_prompts[].xπροαιρετικό
Τύποςinteger | null
Θέση του prompt στον άξονα X.
point_prompts[].yπροαιρετικό
Τύποςinteger | null
Θέση του prompt στον άξονα Y.
point_prompts[].labelπροαιρετικό
Τύποςenum
01
Ετικέτα προσκηνίου/φόντου: το 1 δηλώνει προσκήνιο· το 0 δηλώνει φόντο.
point_prompts[].object_idπροαιρετικό
Τύποςinteger | null
Προαιρετικό αναγνωριστικό που ομαδοποιεί prompt για τη βελτίωση ενός αντικειμένου. Αν παρέχεται επίσης κείμενο ως prompt, αυτό το αναγνωριστικό καθορίζει ποιο εντοπισμένο αντικείμενο βελτιώνουν αυτά τα σημεία.
box_promptsπροαιρετικό
Τύποςobject[]
Προεπιλογή[]
Box prompt που παράγουν μεμονωμένες μάσκες αντικειμένων για τρισδιάστατη ανακατασκευή μέσω αυτόματης τμηματοποίησης και χρησιμοποιούνται μόνο όταν δεν παρέχονται μάσκες. Μπορούν να υποβληθούν πολλά πλαίσια.
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: η ενεργοποίηση αντικαθιστά τα χρώματα κορυφών με ενσωματωμένη υφή και 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 είναι ένα αντίγραφο στην αποθήκευσή μας: διατηρείται για πάντα (χρέωση ανά 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: πολλά αντικείμενα συναρμολογούνται σε μία σκηνή, ενώ τα υπόλοιπα αποτελέσματα περιέχουν ένα mesh.
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Ξεχωριστά αρχεία mesh GLB για κάθε αντικείμενο, διαθέσιμα μόνο σε σκηνές με πολλά αντικείμενα.
artifacts_zip
object {url, content_type, file_name, file_size} | nullΑρχείο ZIP όλων των τεχνουργημάτων και των μεταδεδομένων.

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

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