Naar inhoud springen

Sam 3 · Video RLE

Integreren

Model-ID sam-3/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/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,095 95 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#rle

Videosegmentatie met seeding via een mask-URL, controle over de frame-index en een lagere ondergrens voor de detectiedrempel

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 · apply_mask · boundingbox_zip · 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 []

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/video-rle?wait=20 prijsopgave → $ 0,095
# 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/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 · Video RLE

Segmenteert video met SAM 3 met behulp van een tekstuele `prompt`, punt- of kaderprompts, of een initieel masker uit `mask_url` dat wordt toegepast op `frame_index`. `detection_threshold` loopt van 0.01 tot 1 en lagere waarden zoals 0.2 tot 0.3 kunnen helpen wanneer tekstprompts mislukken. Kan een zipbestand met begrenzingskaders per frame retourneren via `boundingbox_zip`.

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.
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/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": 95,
    "usd": "0.095",
    "charged": 95,
    "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/video-rle.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt