Zum Inhalt springen

Segment Anything Model 3

Integrieren

Modell-ID sam-3/image
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Diese Anfrage: ≈0,005 $ 5 API-Credits Auf dieser Seite ausführen

API-Schlüssel abrufen
Meta Bildbearbeitung #segmentation#mask#real-time

Bildsegmentierung mit Text-, Punkt- oder Box-Prompts, die Maskenbilder sowie optional Scores und Boxen zurückgibt

Meta · Bild

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

Standard wheel

Textanweisung zur Steuerung der Segmentierung.

•erforderlich image_url
Datei ablegen oder

URL des zu segmentierenden Bilds.

Erweitert text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[VERALTET] Altes Eingabefeld aus Gründen der Abwärtskompatibilität; stattdessen 'prompt' verwenden.

output_format Standard png

Dateiformat des resultierenden Bilds.

Standard 3

Obergrenze für zurückgegebene Masken bei aktiviertem `return_multiple_masks`.

Standard []

Sammlung punktbasierter Prompts.

Standard []

Box-Prompts, deren object_id die Gruppierung bestimmt: Übereinstimmende IDs ordnen Boxen einem Objekt zu, leere IDs stehen für separate Objekte. Mehrere Boxen können angegeben werden, jeweils mit den Koordinaten (x_min, y_min, x_max, y_max).

POST /run/sam-3/image?wait=20 Preis → 0,005 $
# 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/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Segment Anything Model 3

Segmentiert ein Bild mit SAM 3 anhand eines Text-`prompt`, von `point_prompts` oder `box_prompts`. Bei aktiviertem `return_multiple_masks` werden bis zu `max_masks` Masken zurückgegeben (1 bis 32). Optionale Konfidenzwerte und Begrenzungsboxen können eingeschlossen werden. Das Ausgabeformat ist jpeg, png oder webp.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
image_urlerforderlich image
Typurl · image
URL des zu segmentierenden Bilds.
promptoptional
Typstring
Standardwheel
Textanweisung zur Steuerung der Segmentierung.
text_promptoptional
Typstring | null
[VERALTET] Altes Eingabefeld aus Gründen der Abwärtskompatibilität; stattdessen 'prompt' verwenden.
point_promptsoptional
Typobject[]
Standard[]
Sammlung punktbasierter Prompts.
point_prompts[].xoptional
Typinteger | null
Prompt-Position auf der X-Achse.
point_prompts[].yoptional
Typinteger | null
Prompt-Position auf der Y-Achse.
point_prompts[].labeloptional
Typenum
01
Vordergrund-/Hintergrundbezeichnung: 1 bedeutet Vordergrund, 0 Hintergrund.
point_prompts[].object_idoptional
Typinteger | null
Optionaler Bezeichner zur Gruppierung von Prompts, die ein einzelnes Objekt verfeinern. Wenn zusätzlich Text als Prompt angegeben wird, bestimmt dieser Bezeichner, welches erkannte Objekt durch diese Punkte verfeinert wird.
point_prompts[].frame_indexoptional
Typinteger | null
Index zur Identifizierung des Frames für die Interaktion.
box_promptsoptional
Typobject[]
Standard[]
Box-Prompts, deren object_id die Gruppierung bestimmt: Übereinstimmende IDs ordnen Boxen einem Objekt zu, leere IDs stehen für separate Objekte. Mehrere Boxen können angegeben werden, jeweils mit den Koordinaten (x_min, y_min, x_max, y_max).
box_prompts[].x_minoptional
Typinteger | null
Minimaler x-Koordinatenwert der Box.
box_prompts[].y_minoptional
Typinteger | null
Minimaler y-Koordinatenwert der Box.
box_prompts[].x_maxoptional
Typinteger | null
Maximale X-Koordinate der Box.
box_prompts[].y_maxoptional
Typinteger | null
Maximale Y-Koordinate der Box.
box_prompts[].object_idoptional
Typinteger | null
Optionaler Bezeichner zur Gruppierung von Boxen, die ein einzelnes Objekt verfeinern.
box_prompts[].frame_indexoptional
Typinteger | null
Index zur Identifizierung des Frames für die Interaktion.
apply_maskoptional
Typboolean
Standardtrue
Steuert, ob die Maske auf das Bild angewendet wird.
output_formatoptional
Typenum
Standardpng
jpegpngwebp
Dateiformat des resultierenden Bilds.
return_multiple_masksoptional
Typboolean
Standardfalse
Option zur Rückgabe mehrerer Masken: Bei Aktivierung bestimmt `max_masks`, wie viele generierte Masken hochgeladen und in die Antwort aufgenommen werden.
max_masksoptional
Typinteger
Standard3
1 – 32
Obergrenze für zurückgegebene Masken bei aktiviertem `return_multiple_masks`.
include_scoresoptional
Typboolean
Standardfalse
Steuert, ob Konfidenzwerte für Masken enthalten sind.
include_boxesoptional
Typboolean
Standardfalse
Steuert, ob für jede Maske, sofern verfügbar, eine Bounding Box enthalten ist.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/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": 5,
    "usd": "0.005",
    "charged": 5,
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
image
object {url, content_type, file_name, file_size, width, height} | nullVorschau der primären Segmentierungsmaske.
masks
array of object {url, content_type, file_name, file_size, width, height}Bilder mit Segmentierungsmasken.
metadata
array of object {index, score, box} | nullMetadaten für jede Maske, einschließlich ihres Scores und ihrer Box.
scores
array of number | nullKonfidenzscore für jede Maske, sofern angefordert.
boxes
array of array of number | nullNormalisierte Boxen für jede Maske, ausgedrückt als [cx, cy, w, h], sofern angefordert.

Weitere Modelle: Bildbearbeitung

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/sam-3/image.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt