Naar inhoud springen

Sam 3 1 · Video

Integreren

Model-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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

SAM 3.1-videosegmentatie die maximaal 128 objecten volgt en uitvoer geeft als mp4 of webm

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 video_output_type · detection_threshold · max_num_objects · apply_mask · point_prompts · box_prompts
video_output_type standaard X264 (.mp4)

Uitvoertype van de resulterende video.

standaard 0.5

Drempel voor detectievertrouwen. Een lagere waarde verhoogt het aantal detecties ten koste van precisie; het bereik is 0.0–1.0.

standaard 16

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

standaard []

Verzameling prompts op basis van punten.

standaard []

Box-prompts als coördinaattupels (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/video?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.ru/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.ru/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

Segmenteert en volgt objecten in een video met SAM 3.1 op basis van een door komma's gescheiden tekstuele `prompt`, punten of kaders. `max_num_objects` bepaalt hoeveel objecten worden gevolgd, van 1 to 128 (standaard 16). `detection_threshold` loopt van 0.1 to 1. De uitvoer is X264 (.mp4) of VP9 (.webm).

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.
promptoptioneel
Typestring
Standaard
Segmentatieprompt die meerdere gevolgde objecten ondersteunt via kommagescheiden beschrijvingen, zoals 'person, cloth'.
point_promptsoptioneel
Typeobject[]
Standaard[]
Verzameling prompts op basis van punten.
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.
box_promptsoptioneel
Typeobject[]
Standaard[]
Box-prompts als coördinaattupels (x_min, y_min, x_max, y_max).
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.
apply_maskoptioneel
Typeboolean
Standaardtrue
Of maskering op de video moet worden toegepast.
video_output_typeoptioneel
Typeenum
StandaardX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Uitvoertype van de resulterende video.
detection_thresholdoptioneel
Typenumber
Standaard0.5
0,1 – 1
Drempel voor detectievertrouwen. Een lagere waarde verhoogt het aantal detecties ten koste van precisie; het bereik is 0.0–1.0.
max_num_objectsoptioneel
Typeinteger
Standaard16
1 – 128
Bovengrens voor het aantal objecten dat in de video wordt gevolgd.
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",
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt