Vai al contenuto

Sam 3 1 · Video RLE

Integra

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

File come nell'esempio: 0,19 $ 190 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

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

Segmentazione video con SAM 3.1, maschere RLE, inizializzazione della maschera e maschere opzionali per oggetto e fotogramma

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.

predefinito

Prompt di segmentazione che supporta più oggetti tracciati tramite descrizioni separate da virgole, come 'person, cloth'.

•obbligatorio video_url
Trascina un file oppure

URL del video per la segmentazione.

Avanzate mask · detection_threshold · frame_index · max_num_objects · apply_mask · boundingbox_zip · return_object_rles · point_prompts · box_prompts
mask_url
Trascina un file oppure

URL della maschera per l'applicazione iniziale.

predefinito 0.5

Soglia di confidenza del rilevamento, con valori predefiniti di 0.5 per gli oggetti esistenti e 0.7 per quelli nuovi. Nell'intervallo 0.0–1.0, valori inferiori sacrificano la precisione per ottenere più rilevamenti; prova 0.2–0.3 quando i prompt testuali non funzionano.

predefinito 0

Indice del fotogramma per l'interazione iniziale quando si fornisce mask_url.

predefinito 16

Limite massimo al numero di oggetti tracciati nel video.

predefinito []

Elenco di prompt punto che specifica gli indici dei fotogrammi.

predefinito []

Elenco di prompt riquadro, con un frame_index facoltativo per ogni voce.

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

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 Sam 3 1 · Video RLE

Segmenta video con SAM 3.1, inizializzato da un `prompt` testuale, da prompt puntuali o rettangolari oppure da un `mask_url` applicato a `frame_index`. `max_num_objects` consente di tracciare da 1 a 128 oggetti. Imposta `return_object_rles` per ottenere la maschera di ciascun oggetto tracciato per ogni fotogramma, con un ID stabile. `detection_threshold` va da 0.01 a 1.

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.
promptfacoltativo
Tipostring
Predefinito
Prompt di segmentazione che supporta più oggetti tracciati tramite descrizioni separate da virgole, come 'person, cloth'.
point_promptsfacoltativo
Tipoobject[]
Predefinito[]
Elenco di prompt punto che specifica gli indici dei fotogrammi.
point_prompts[].xfacoltativo
Tipointeger | null
Posizione del prompt lungo l'asse X.
point_prompts[].yfacoltativo
Tipointeger | null
Posizione del prompt lungo l'asse Y.
point_prompts[].labelfacoltativo
Tipoenum
01
Etichetta primo piano/sfondo: 1 indica il primo piano; 0 indica lo sfondo.
point_prompts[].object_idfacoltativo
Tipointeger | null
Identificatore facoltativo che raggruppa i prompt che perfezionano un singolo oggetto. Se viene fornito anche testo come prompt, questo identificatore determina quale oggetto rilevato viene perfezionato da quei punti.
point_prompts[].frame_indexfacoltativo
Tipointeger | null
Indice che identifica il fotogramma per l'interazione.
box_promptsfacoltativo
Tipoobject[]
Predefinito[]
Elenco di prompt riquadro, con un frame_index facoltativo per ogni voce.
box_prompts[].x_minfacoltativo
Tipointeger | null
Coordinata x minima del riquadro.
box_prompts[].y_minfacoltativo
Tipointeger | null
Coordinata y minima del riquadro.
box_prompts[].x_maxfacoltativo
Tipointeger | null
Coordinata X massima del riquadro.
box_prompts[].y_maxfacoltativo
Tipointeger | null
Coordinata Y massima del riquadro.
box_prompts[].object_idfacoltativo
Tipointeger | null
Identificatore facoltativo che raggruppa i riquadri che perfezionano un singolo oggetto.
box_prompts[].frame_indexfacoltativo
Tipointeger | null
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.
detection_thresholdfacoltativo
Tiponumber
Predefinito0.5
0,01 – 1
Soglia di confidenza del rilevamento, con valori predefiniti di 0.5 per gli oggetti esistenti e 0.7 per quelli nuovi. Nell'intervallo 0.0–1.0, valori inferiori sacrificano la precisione per ottenere più rilevamenti; prova 0.2–0.3 quando i prompt testuali non funzionano.
frame_indexfacoltativo
Tipointeger
Predefinito0
Indice del fotogramma per l'interazione iniziale quando si fornisce mask_url.
max_num_objectsfacoltativo
Tipointeger
Predefinito16
1 – 128
Limite massimo al numero di oggetti tracciati nel video.
return_object_rlesfacoltativo
Tipoboolean
Predefinitofalse
Indica se restituire anche una maschera separata per ogni oggetto tracciato in ogni fotogramma, usando un ID oggetto stabile per tutto il video. La risposta include comunque l'rle unificato.
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": "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"
  }
}
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/sam-3-1/video-rle.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt