Saltar al cuntegna

Segment Anything Model 2 · Video

Integrar

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

Fin a $4,00 per execuziun pajà tenor l'utilisaziun effectiva, il rest vegn restituì Lantschar sin questa pagina

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

Segmentescha e persequitescha objects en in video a partir da prompts da puncts u rectangels, cun ina masca iniziala opziunala

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.

•obligatori video_url
Trametta in datoteca u

URL dal video per la segmentaziun.

Avanzà mask · apply_mask · boundingbox_zip · prompts · box_prompts
mask_url
Trametta in datoteca u

URL da la maska per l'applicaziun iniziala.

standard []

Prompts utilisads per la segmentaziun da videos.

standard []

Coordinatas dals cunfins da la box.

POST /run/sam2/video?wait=20 calculaziun → $4,00
# 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/sam2/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"

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 Segment Anything Model 2 · Video

Segmentescha in video cun SAM 2. Dirigì cun `prompts` u `box_prompts`, u furnescha ina masca iniziala tras `mask_url`. `apply_mask` surimpona la masca al video da sortida. Activescha `boundingbox_zip` per retschaiver er surimposiziuns da las boxas da limitaziun per mintga frame sco archiv zip.

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.
promptsopziunal
Tipobject[]
Standard[]
Prompts utilisads per la segmentaziun da videos.
prompts[].xopziunal
Tipinteger
Standard305
Posiziun dal prompt sin l'axa X.
prompts[].yopziunal
Tipinteger
Standard350
Posiziun dal prompt sin l'axa Y.
prompts[].labelopziunal
Tipenum
Standard1
01
Etichetta dal prompt: 1 inditgescha il primplan, entant che 0 inditgescha il fund.
prompts[].frame_indexopziunal
Tipinteger
Standard0
Index che identifitgescha il frame per l'interacziun.
box_promptsopziunal
Tipobject[]
Standard[]
Coordinatas dals cunfins da la box.
box_prompts[].x_minopziunal
Tipinteger
Standard0
Coordonada x minimala per la box.
box_prompts[].y_minopziunal
Tipinteger
Standard0
Coordonada y minimala per la box.
box_prompts[].x_maxopziunal
Tipinteger
Standard0
Coordonada x maximala per il prompt.
box_prompts[].y_maxopziunal
Tipinteger
Standard0
Coordonada y maximala per il prompt.
box_prompts[].frame_indexopziunal
Tipinteger
Standard0
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à.
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": "sam2/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": 4000,
    "usd": "4.00",
    "charged": 4000,
    "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/sam2/video.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt