Zum Inhalt springen

Sam 3 1 · Video

Integrieren

Modell-ID sam-3-1/video
# 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-1/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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"

Dateien wie das Beispiel: 0,19 $ 190 API-Credits Deine Dateien werden vor der Ausführung gemessen Auf dieser Seite ausführen

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

SAM-3.1-Videosegmentierung, die bis zu 128 Objekte verfolgt und als mp4 oder webm ausgibt

Meta · Video

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

Segmentierungs-Prompt zur Unterstützung mehrerer getrackter Objekte durch kommagetrennte Beschreibungen wie 'person, cloth'.

•erforderlich video_url
Datei ablegen oder

Video-URL für die Segmentierung.

Erweitert video_output_type · detection_threshold · max_num_objects · apply_mask · point_prompts · box_prompts
video_output_type Standard X264 (.mp4)

Ausgabetyp des resultierenden Videos.

Standard 0.5

Konfidenzgrenzwert für die Erkennung. Ein niedrigerer Wert erhöht die Anzahl der Erkennungen zulasten der Präzision; der Bereich ist 0.0–1.0.

Standard 16

Obergrenze für die Anzahl der im Video getrackten Objekte.

Standard []

Sammlung punktbasierter Prompts.

Standard []

Box-Prompts als Koordinatentupel (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/video?wait=20 Preis → 0,19 $
# 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-1/video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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 Sam 3 1 · Video

Segmentiert und verfolgt Objekte in einem Video mit SAM 3.1 anhand eines durch Kommas getrennten Text-`prompt`, von Punkten oder Boxen. `max_num_objects` legt fest, wie viele Objekte verfolgt werden, von 1 bis 128 (Standard 16). `detection_threshold` reicht von 0.1 bis 1. Die Ausgabe ist X264 (.mp4) oder VP9 (.webm).

Parameter

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

NameTyp StandardZulässig Beschreibung
video_urlerforderlich video
Typurl · video
Video-URL für die Segmentierung.
promptoptional
Typstring
Standard
Segmentierungs-Prompt zur Unterstützung mehrerer getrackter Objekte durch kommagetrennte Beschreibungen wie 'person, cloth'.
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.
box_promptsoptional
Typobject[]
Standard[]
Box-Prompts als Koordinatentupel (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.
apply_maskoptional
Typboolean
Standardtrue
Gibt an, ob Maskierung auf das Video angewendet werden soll.
video_output_typeoptional
Typenum
StandardX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Ausgabetyp des resultierenden Videos.
detection_thresholdoptional
Typnumber
Standard0.5
0,1 – 1
Konfidenzgrenzwert für die Erkennung. Ein niedrigerer Wert erhöht die Anzahl der Erkennungen zulasten der Präzision; der Bereich ist 0.0–1.0.
max_num_objectsoptional
Typinteger
Standard16
1 – 128
Obergrenze für die Anzahl der im Video getrackten Objekte.
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-1/video",
  "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": 190,
    "usd": "0.19",
    "charged": 190,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "boundingbox_frames_zip": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "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
video
object {url, content_type, file_name, file_size}Durch Segmentierung erzeugtes Video.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP-Archiv mit Bounding-Box-Overlays für jedes Frame.

Weitere Modelle: Video zu Video

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