Vai al contenuto

Segment Anything Model 2 · Video

Integra

ID del modello 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"

Fino a 4,00 $ per esecuzione addebitato in base all'utilizzo effettivo, il resto viene rimborsato Esegui in questa pagina

Ottieni la chiave API
Meta Da video a video #segmentation#mask#real-time

Segmenta e traccia gli oggetti in un video a partire da prompt di punti o riquadri, con una maschera iniziale opzionale

Meta · Video

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio video_url
Trascina un file oppure

URL del video per la segmentazione.

Avanzate mask · apply_mask · boundingbox_zip · prompts · box_prompts
mask_url
Trascina un file oppure

URL della maschera per l'applicazione iniziale.

predefinito []

Prompt usati per la segmentazione del video.

predefinito []

Coordinate dei bordi del riquadro.

POST /run/sam2/video?wait=20 preventivo → 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"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Segment Anything Model 2 · Video

Segmenta un video con SAM 2. Guidalo con `prompts` o `box_prompts`, oppure fornisci una maschera iniziale tramite `mask_url`. `apply_mask` sovrappone la maschera al video di output. Abilita `boundingbox_zip` per ricevere anche le sovrapposizioni dei riquadri di delimitazione per ogni fotogramma in un archivio zip.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
video_urlobbligatorio video
Tipourl · video
URL del video per la segmentazione.
mask_urlfacoltativo mask
Tipourl · image
URL della maschera per l'applicazione iniziale.
promptsfacoltativo
Tipoobject[]
Predefinito[]
Prompt usati per la segmentazione del video.
prompts[].xfacoltativo
Tipointeger
Predefinito305
Posizione del prompt lungo l'asse X.
prompts[].yfacoltativo
Tipointeger
Predefinito350
Posizione del prompt lungo l'asse Y.
prompts[].labelfacoltativo
Tipoenum
Predefinito1
01
Etichetta del prompt: 1 indica il primo piano, mentre 0 indica lo sfondo.
prompts[].frame_indexfacoltativo
Tipointeger
Predefinito0
Indice che identifica il fotogramma per l'interazione.
box_promptsfacoltativo
Tipoobject[]
Predefinito[]
Coordinate dei bordi del riquadro.
box_prompts[].x_minfacoltativo
Tipointeger
Predefinito0
Coordinata x minima del riquadro.
box_prompts[].y_minfacoltativo
Tipointeger
Predefinito0
Coordinata y minima del riquadro.
box_prompts[].x_maxfacoltativo
Tipointeger
Predefinito0
Coordinata x massima del prompt.
box_prompts[].y_maxfacoltativo
Tipointeger
Predefinito0
Coordinata y massima del prompt.
box_prompts[].frame_indexfacoltativo
Tipointeger
Predefinito0
Indice che identifica il fotogramma per l'interazione.
apply_maskfacoltativo
Tipoboolean
Predefinitofalse
Indica se applicare la mascheratura al video.
boundingbox_zipfacoltativo
Tipoboolean
Predefinitofalse
Indica se restituire un archivio ZIP contenente le sovrapposizioni dei riquadri per ogni fotogramma.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
video
object {url, content_type, file_name, file_size}Video prodotto dalla segmentazione.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArchivio ZIP delle sovrapposizioni dei riquadri per ogni fotogramma.

Altri modelli: Da video a video

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/sam2/video.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt