Naar inhoud springen

Sam 3 1 · Video RLE

Integreren

Model-ID sam-3-1/video-rle
# 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-rle?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"

Bestanden zoals het voorbeeld: $ 0,19 190 API-tegoed je bestanden worden vóór de uitvoering gemeten Op deze pagina uitvoeren

API-sleutel ophalen
Meta Video naar video #segmentation#mask#real-time

Videosegmentatie met SAM 3.1 en RLE-maskers, maskerseeding en optionele maskers per object per frame

Meta · Video

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

standaard

Segmentatieprompt die meerdere gevolgde objecten ondersteunt via kommagescheiden beschrijvingen, zoals 'person, cloth'.

•verplicht video_url
Sleep een bestand hierheen of

Video-URL voor segmentatie.

Geavanceerd mask · detection_threshold · frame_index · max_num_objects · apply_mask · boundingbox_zip · return_object_rles · point_prompts · box_prompts
mask_url
Sleep een bestand hierheen of

Masker-URL voor de eerste toepassing.

standaard 0.5

Drempel voor detectievertrouwen, standaard 0.5 voor bestaande objecten en 0.7 voor nieuwe objecten. Binnen het bereik 0.0–1.0 leveren lagere waarden precisie in voor meer detecties; probeer 0.2–0.3 wanneer tekstprompts mislukken.

standaard 0

Index van het frame voor de eerste interactie bij het aanleveren van mask_url.

standaard 16

Bovengrens voor het aantal objecten dat in de video wordt gevolgd.

standaard []

Lijst met point-prompts die frame-indices specificeert.

standaard []

Lijst met box-prompts, met een optionele frame_index voor elke invoer.

POST /run/sam-3-1/video-rle?wait=20 prijsopgave → $ 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-rle?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"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Sam 3 1 · Video RLE

Segmenteert video met SAM 3.1, gestart met een tekstuele `prompt`, punt- of boxprompts, of een `mask_url` toegepast op `frame_index`. Met `max_num_objects` kun je 1 tot 128 gevolgde objecten instellen. Stel `return_object_rles` in om per frame het eigen masker van elk gevolgd object met een stabiele id te krijgen. `detection_threshold` loopt van 0.01 tot 1.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
video_urlverplicht video
Typeurl · video
Video-URL voor segmentatie.
mask_urloptioneel mask
Typeurl · image
Masker-URL voor de eerste toepassing.
promptoptioneel
Typestring
Standaard
Segmentatieprompt die meerdere gevolgde objecten ondersteunt via kommagescheiden beschrijvingen, zoals 'person, cloth'.
point_promptsoptioneel
Typeobject[]
Standaard[]
Lijst met point-prompts die frame-indices specificeert.
point_prompts[].xoptioneel
Typeinteger | null
Promptpositie langs de X-as.
point_prompts[].yoptioneel
Typeinteger | null
Promptpositie langs de Y-as.
point_prompts[].labeloptioneel
Typeenum
01
Label voor voorgrond/achtergrond: 1 geeft voorgrond aan; 0 geeft achtergrond aan.
point_prompts[].object_idoptioneel
Typeinteger | null
Optionele identifier die prompts groepeert die één object verfijnen. Als ook tekst als prompt wordt opgegeven, bepaalt deze identifier welk gedetecteerd object die punten verfijnen.
point_prompts[].frame_indexoptioneel
Typeinteger | null
Index die het frame voor interactie identificeert.
box_promptsoptioneel
Typeobject[]
Standaard[]
Lijst met box-prompts, met een optionele frame_index voor elke invoer.
box_prompts[].x_minoptioneel
Typeinteger | null
Minimale x-coördinaat van het vak.
box_prompts[].y_minoptioneel
Typeinteger | null
Minimale y-coördinaat van het vak.
box_prompts[].x_maxoptioneel
Typeinteger | null
Maximale X-coördinaat voor de box.
box_prompts[].y_maxoptioneel
Typeinteger | null
Maximale Y-coördinaat voor de box.
box_prompts[].object_idoptioneel
Typeinteger | null
Optionele identifier voor het groeperen van boxen die één object verfijnen.
box_prompts[].frame_indexoptioneel
Typeinteger | null
Index die het frame voor interactie identificeert.
apply_maskoptioneel
Typeboolean
Standaardfalse
Of maskering op de video moet worden toegepast.
boundingbox_zipoptioneel
Typeboolean
Standaardfalse
Of een ZIP-archief met overlays van de kaders voor elk frame moet worden geretourneerd.
detection_thresholdoptioneel
Typenumber
Standaard0.5
0,01 – 1
Drempel voor detectievertrouwen, standaard 0.5 voor bestaande objecten en 0.7 voor nieuwe objecten. Binnen het bereik 0.0–1.0 leveren lagere waarden precisie in voor meer detecties; probeer 0.2–0.3 wanneer tekstprompts mislukken.
frame_indexoptioneel
Typeinteger
Standaard0
Index van het frame voor de eerste interactie bij het aanleveren van mask_url.
max_num_objectsoptioneel
Typeinteger
Standaard16
1 – 128
Bovengrens voor het aantal objecten dat in de video wordt gevolgd.
return_object_rlesoptioneel
Typeboolean
Standaardfalse
Of naast het samengevoegde rle ook een afzonderlijk masker per gevolgd object in elk frame moet worden geretourneerd, met gedurende de hele video een stabiele object-ID.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/video-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": 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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
video
object {url, content_type, file_name, file_size}Video die door segmentatie is geproduceerd.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullZIP-archief met overlays van de kaders voor elk frame.

Meer modellen: Video naar video

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/sam-3-1/video-rle.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt