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

Sam 3 · Image RLE

Ενσωμάτωση

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

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

Τμηματοποίηση εικόνας που επιστρέφει τη μάσκα ως δεδομένα κωδικοποιημένα σε run-length αντί για εικόνα

Meta · Δεδομένα (JSON)

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

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

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

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

προεπιλογή wheel

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

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

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

Για προχωρημένους text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] Παλαιού τύπου είσοδος που διατηρείται για συμβατότητα προς τα πίσω· χρησιμοποιήστε το 'prompt' στη θέση της.

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/image-rle?wait=20 προσφορά → 0,005 $
# 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/image-rle?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 · Image RLE

Εκτελεί τμηματοποίηση SAM 3 σε εικόνα χρησιμοποιώντας κειμενικό `prompt`, σημεία ή πλαίσια και επιστρέφει τη μάσκα ως δεδομένα κωδικοποίησης μήκους διαδρομής (RLE). Είναι χρήσιμο όταν χρειάζεστε συμπαγή δεδομένα μάσκας για μετεπεξεργασία. Υποστηρίζει `return_multiple_masks` με `max_masks` από 1 έως 32, καθώς και προαιρετικές βαθμολογίες και πλαίσια.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlαπαιτείται image
Τύποςurl · image
URL της εικόνας προς τμηματοποίηση.
promptπροαιρετικό
Τύποςstring
Προεπιλογήwheel
Οδηγία κειμένου για την καθοδήγηση της τμηματοποίησης.
text_promptπροαιρετικό
Τύποςstring | null
[DEPRECATED] Παλαιού τύπου είσοδος που διατηρείται για συμβατότητα προς τα πίσω· χρησιμοποιήστε το 'prompt' στη θέση της.
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/image-rle",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "rle": "string",
    "boundingbox_frames_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
    },
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "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 είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
rle
string | array of stringΜάσκα που αναπαρίσταται με κωδικοποίηση μήκους διαδρομής.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullΑρχείο ZIP με επικαλύψεις πλαισίων οριοθέτησης για κάθε καρέ.
metadata
array of object {index, score, box} | nullΜεταδεδομένα για κάθε μάσκα, τα οποία περιλαμβάνονται όταν η απόκριση περιέχει πολλαπλά RLE.
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/image-rle.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt