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.ru/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.ru/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; el resto se reembolsa Ejecutar en esta página

Obtener clave de API
Meta Video a video #segmentation#mask#real-time

Segmenta y rastrea objetos a lo largo de un video a partir de indicaciones de puntos o cuadros, con una máscara inicial opcional

Meta · Video

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, donde se conservan 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 conforme los cambias.

•obligatorio video_url
Suelta un archivo o

URL del video 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 usados para la segmentación de video.

predeterminado []

Coordenadas de los límites del cuadro.

POST /run/sam2/video?wait=20 cotización → $4.00
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/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 se guarda en localStorage únicamente si marcas Recordar. Obtener una clave de API

Acerca de Segment Anything Model 2 · Video

Segmenta un video 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 en el video 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, no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
video_urlobligatorio video
Tipourl · video
URL del video para la segmentación.
mask_urlopcional mask
Tipourl · image
URL de la máscara para la aplicación inicial.
promptsopcional
Tipoobject[]
Predeterminado[]
Prompts usados para la segmentación de video.
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 cuadro.
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 video.
boundingbox_zipopcional
Tipoboolean
Predeterminadofalse
Indica si se debe devolver un archivo ZIP con superposiciones de cuadros 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 carga. 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: se conserva para siempre (con cobro 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 video y audio. output es el objeto de resultado propio del modelo.
Campos de salida
video
object {url, content_type, file_name, file_size}Video producido mediante segmentación.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArchivo ZIP con superposiciones de cuadros delimitadores para cada fotograma.

Más modelos: Video a video

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