Saltar al cuntegna

Sam 3 1 · Video RLE

Integrar

ID dal model 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"

Datotecas sco l'exempel: $0,19 190 credits API tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
Meta Video a video #segmentation#mask#real-time

Segmentaziun da video cun SAM 3.1, mascras RLE, semenza da mascras e mascras facultativas per object e frame

Meta · Video

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

standard

Prompt da segmentaziun che sustegna plirs objects persequitads cun descripziuns separadas da virgulas, sco 'person, cloth'.

•obligatori video_url
Trametta in datoteca u

URL dal video per la segmentaziun.

Avanzà mask · detection_threshold · frame_index · max_num_objects · apply_mask · boundingbox_zip · return_object_rles · point_prompts · box_prompts
mask_url
Trametta in datoteca u

URL da la maska per l'applicaziun iniziala.

standard 0.5

Limita da confidenza per la detecziun, cun 0.5 sco standard per objects existents e 0.7 per objects novs. Entaifer la plaja 0.0–1.0 barattan valurs pli pitschnas la precisiun per dapli detecziuns; emprova 0.2–0.3 sche prompts da text falleschan.

standard 0

Index dal frame per l'interacziun iniziala, sch'ins furnescha mask_url.

standard 16

Limita superiura dal dumber d'objects persequitads en il video.

standard []

Glista da point prompts che specifitgescha ils indices dals frames.

standard []

Glista da box prompts, cun in frame_index opziunal per mintga entrada.

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

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Sam 3 1 · Video RLE

Segmentescha videos cun SAM 3.1, inizià cun in `prompt` textual, prompts da punct u da box, u ina `mask_url` applitgada a `frame_index`. `max_num_objects` permetta da suandar 1 fin 128 objects. Activescha `return_object_rles` per survegnir la mascras da mintga object suandà per frame cun in ID stabil. `detection_threshold` va da 0.01 fin 1.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
video_urlobligatori video
Tipurl · video
URL dal video per la segmentaziun.
mask_urlopziunal mask
Tipurl · image
URL da la maska per l'applicaziun iniziala.
promptopziunal
Tipstring
Standard
Prompt da segmentaziun che sustegna plirs objects persequitads cun descripziuns separadas da virgulas, sco 'person, cloth'.
point_promptsopziunal
Tipobject[]
Standard[]
Glista da point prompts che specifitgescha ils indices dals frames.
point_prompts[].xopziunal
Tipinteger | null
Posiziun dal prompt sin l'axa X.
point_prompts[].yopziunal
Tipinteger | null
Posiziun dal prompt sin l'axa Y.
point_prompts[].labelopziunal
Tipenum
01
Label dal primplan/fund: 1 inditgescha il primplan; 0 inditgescha il fund.
point_prompts[].object_idopziunal
Tipinteger | null
Identifitgader opziunal che gruppescha prompts che megliereschan in singul object. Sche text vegn er furnì sco prompt, determinescha quest identifitgader tge object detectà che quels puncts megliereschan.
point_prompts[].frame_indexopziunal
Tipinteger | null
Index che identifitgescha il frame per l'interacziun.
box_promptsopziunal
Tipobject[]
Standard[]
Glista da box prompts, cun in frame_index opziunal per mintga entrada.
box_prompts[].x_minopziunal
Tipinteger | null
Coordonada x minimala per la box.
box_prompts[].y_minopziunal
Tipinteger | null
Coordonada y minimala per la box.
box_prompts[].x_maxopziunal
Tipinteger | null
Coordinata X maximala dal box.
box_prompts[].y_maxopziunal
Tipinteger | null
Coordinata Y maximala dal box.
box_prompts[].object_idopziunal
Tipinteger | null
Identifitgader opziunal che gruppescha boxes che megliereschan in singul object.
box_prompts[].frame_indexopziunal
Tipinteger | null
Index che identifitgescha il frame per l'interacziun.
apply_maskopziunal
Tipboolean
Standardfalse
Sche la masca duai vegnir applitgada al video.
boundingbox_zipopziunal
Tipboolean
Standardfalse
Sche in archiv ZIP cun overlays da las bounding boxes per mintga frame duai vegnir returnà.
detection_thresholdopziunal
Tipnumber
Standard0.5
0,01 – 1
Limita da confidenza per la detecziun, cun 0.5 sco standard per objects existents e 0.7 per objects novs. Entaifer la plaja 0.0–1.0 barattan valurs pli pitschnas la precisiun per dapli detecziuns; emprova 0.2–0.3 sche prompts da text falleschan.
frame_indexopziunal
Tipinteger
Standard0
Index dal frame per l'interacziun iniziala, sch'ins furnescha mask_url.
max_num_objectsopziunal
Tipinteger
Standard16
1 – 128
Limita superiura dal dumber d'objects persequitads en il video.
return_object_rlesopziunal
Tipboolean
Standardfalse
Sche mintga object persequità duai survegnir ina maska separada en mintga frame, cun in ID stabil durant tut il video. La resposta cuntegna tuttina il rle fusiunà.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

Output

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
video
object {url, content_type, file_name, file_size}Video producì da la segmentaziun.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArchiv ZIP cun overlays da las bounding boxes per mintga frame.

Dapli models: Video a video

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/sam-3-1/video-rle.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt