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

Sam 3 1 · Image

Ενσωμάτωση

id μοντέλου sam-3-1/image
# 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-1/image?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,01 $ 10 πιστώσεις API · ≈ 1,05 ₽ Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Meta Επεξεργασία εικόνας #segmentation#mask#real-time

Τμηματοποίηση εικόνας με SAM 3.1 από prompt κειμένου, σημείων ή πλαισίων, με επιστροφή εικόνων μάσκας

Meta · Εικόνα

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

Τα στοιχεία ελέγχου δημιουργούνται από το σχήμα του μοντέλου. Ο κώδικας και η τιμή ενημερώνονται καθώς τα αλλάζετε.

προεπιλογή wheel

Οδηγία κειμένου για την καθοδήγηση της τμηματοποίησης.

•απαιτείται image_url
Αποθέστε ένα αρχείο ή

URL της εικόνας προς τμηματοποίηση.

Για προχωρημένους output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format προεπιλογή png

Μορφή αρχείου της τελικής εικόνας.

προεπιλογή 3

Ανώτατο όριο επιστρεφόμενων μασκών όταν είναι ενεργό το `return_multiple_masks`.

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

Συλλογή prompt που βασίζονται σε σημεία.

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

Prompt πλαισίων των οποίων το object_id καθορίζει την ομαδοποίηση: τα ίδια ID συσχετίζουν τα πλαίσια με ένα αντικείμενο, ενώ τα κενά ID δηλώνουν ξεχωριστά αντικείμενα. Μπορούν να παρέχονται πολλά πλαίσια, καθένα με συντεταγμένες (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/image?wait=20 προσφορά → 0,01 $
# 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-1/image?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 1 · Image

Εκτελεί τμηματοποίηση μίας εικόνας με το SAM 3.1 χρησιμοποιώντας κειμενικό `prompt`, `point_prompts` ή `box_prompts`. Πολλά πλαίσια μπορούν να ομαδοποιηθούν ανά αντικείμενο με το object_id. Το `return_multiple_masks` επιστρέφει έως `max_masks` μάσκες (1 έως 32), με προαιρετικές βαθμολογίες και πλαίσια οριοθέτησης. Η μορφή εξόδου είναι jpeg, png ή webp.

Παράμετροι

Στείλτε είτε το κανονικό όνομα είτε το εγγενές όνομα, όχι και τα δύο. Κανονικά ονόματα

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlαπαιτείται image
Τύποςurl · image
URL της εικόνας προς τμηματοποίηση.
promptπροαιρετικό
Τύποςstring
Προεπιλογήwheel
Οδηγία κειμένου για την καθοδήγηση της τμηματοποίησης.
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, αυτό το αναγνωριστικό καθορίζει ποιο εντοπισμένο αντικείμενο βελτιώνουν αυτά τα σημεία.
point_prompts[].frame_indexπροαιρετικό
Τύποςinteger | null
Δείκτης που προσδιορίζει το καρέ για αλληλεπίδραση.
box_promptsπροαιρετικό
Τύποςobject[]
Προεπιλογή[]
Prompt πλαισίων των οποίων το object_id καθορίζει την ομαδοποίηση: τα ίδια ID συσχετίζουν τα πλαίσια με ένα αντικείμενο, ενώ τα κενά ID δηλώνουν ξεχωριστά αντικείμενα. Μπορούν να παρέχονται πολλά πλαίσια, καθένα με συντεταγμένες (x_min, y_min, x_max, y_max).
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
Προαιρετικό αναγνωριστικό που ομαδοποιεί πλαίσια για τη βελτίωση ενός αντικειμένου.
box_prompts[].frame_indexπροαιρετικό
Τύποςinteger | null
Δείκτης που προσδιορίζει το καρέ για αλληλεπίδραση.
apply_maskπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ελέγχει αν εφαρμόζεται η μάσκα στην εικόνα.
output_formatπροαιρετικό
Τύποςenum
Προεπιλογήpng
jpegpngwebp
Μορφή αρχείου της τελικής εικόνας.
return_multiple_masksπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Επιλογή επιστροφής πολλαπλών μασκών: η ενεργοποίησή της χρησιμοποιεί το `max_masks` για να καθορίσει πόσες παραγόμενες μάσκες θα μεταφορτωθούν και θα περιληφθούν στην απάντηση.
max_masksπροαιρετικό
Τύποςinteger
Προεπιλογή3
1 – 32
Ανώτατο όριο επιστρεφόμενων μασκών όταν είναι ενεργό το `return_multiple_masks`.
include_scoresπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ελέγχει αν θα περιλαμβάνονται βαθμολογίες βεβαιότητας για τις μάσκες.
include_boxesπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Ελέγχει αν θα περιλαμβάνεται πλαίσιο οριοθέτησης για κάθε μάσκα, όταν είναι διαθέσιμο.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 10 MB ή το file_url μιας μεταφόρτωσης. Αρχεία

Έξοδος

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/image",
  "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": 10,
    "usd": "0.01",
    "charged": 10,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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,
      "width": 1024,
      "height": 768
    },
    "masks": [
      {
        "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,
        "width": 1024,
        "height": 768
      }
    ],
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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 είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
image
object {url, content_type, file_name, file_size, width, height} | nullΠροεπισκόπηση της κύριας μάσκας τμηματοποίησης.
masks
array of object {url, content_type, file_name, file_size, width, height}Εικόνες που περιέχουν μάσκες τμηματοποίησης.
metadata
array of object {index, score, box} | nullΜεταδεδομένα για κάθε μάσκα, συμπεριλαμβανομένης της βαθμολογίας και του πλαισίου της.
scores
array of number | nullΒαθμολογία εμπιστοσύνης για κάθε μάσκα, η οποία παρέχεται όταν ζητείται.
boxes
array of array of number | nullΚανονικοποιημένα πλαίσια για κάθε μάσκα, εκφρασμένα ως [cx, cy, w, h], εφόσον ζητηθούν.

Περισσότερα μοντέλα: Επεξεργασία εικόνας

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