Ir al contenido

Segment Anything Model 2 · Video

Integrar

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

Hasta 4,00 $ por ejecución se cobra según el uso real y el resto se reembolsa Ejecutar en esta página

Obtener clave de API
Meta Vídeo a vídeo #segmentation#mask#real-time

Segmenta y sigue objetos en un vídeo a partir de indicaciones de puntos o cuadros, con una máscara inicial opcional

Meta · Vídeo

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

•obligatorio video_url
Suelta un archivo o

URL del vídeo para la segmentación.

Avanzado mask · apply_mask · boundingbox_zip · prompts · box_prompts
mask_url
Suelta un archivo o

URL de la máscara para la aplicación inicial.

predeterminado []

Prompts utilizados para la segmentación de vídeo.

predeterminado []

Coordenadas de los límites del recuadro.

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

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de Segment Anything Model 2 · Video

Segmenta un vídeo con SAM 2. Guíalo con `prompts` o `box_prompts`, o proporciona una máscara inicial mediante `mask_url`. `apply_mask` superpone la máscara al vídeo de salida. Activa `boundingbox_zip` para recibir también superposiciones de cuadros delimitadores por fotograma en un archivo zip.

Parámetros

Envía el nombre canónico o el nombre nativo, pero no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
video_urlobligatorio video
Tipourl · video
URL del vídeo para la segmentación.
mask_urlopcional mask
Tipourl · image
URL de la máscara para la aplicación inicial.
promptsopcional
Tipoobject[]
Predeterminado[]
Prompts utilizados para la segmentación de vídeo.
prompts[].xopcional
Tipointeger
Predeterminado305
Posición del prompt en el eje X.
prompts[].yopcional
Tipointeger
Predeterminado350
Posición del prompt en el eje Y.
prompts[].labelopcional
Tipoenum
Predeterminado1
01
Etiqueta del prompt: 1 indica el primer plano y 0 indica el fondo.
prompts[].frame_indexopcional
Tipointeger
Predeterminado0
Índice que identifica el fotograma para la interacción.
box_promptsopcional
Tipoobject[]
Predeterminado[]
Coordenadas de los límites del recuadro.
box_prompts[].x_minopcional
Tipointeger
Predeterminado0
Coordenada x mínima del cuadro.
box_prompts[].y_minopcional
Tipointeger
Predeterminado0
Coordenada y mínima del cuadro.
box_prompts[].x_maxopcional
Tipointeger
Predeterminado0
Coordenada x máxima del prompt.
box_prompts[].y_maxopcional
Tipointeger
Predeterminado0
Coordenada y máxima del prompt.
box_prompts[].frame_indexopcional
Tipointeger
Predeterminado0
Índice que identifica el fotograma para la interacción.
apply_maskopcional
Tipoboolean
Predeterminadofalse
Indica si se debe aplicar el enmascaramiento al vídeo.
boundingbox_zipopcional
Tipoboolean
Predeterminadofalse
Indica si se debe devolver un archivo ZIP que contenga superposiciones de recuadros delimitadores para cada fotograma.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una subida. Archivos

Salida

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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (con pago por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
video
object {url, content_type, file_name, file_size}Vídeo producido mediante segmentación.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArchivo ZIP con superposiciones de recuadros delimitadores para cada fotograma.

Más modelos: Vídeo a vídeo

Para agentes de IA: esta página en Markdown está en https://doitong.com/es-ES/developers/models/sam2/video.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt