Ir para o conteúdo

Segment Anything Model 2 · Video

Integrar

ID do 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"

Até $ 4,00 por execução cobrado pelo uso real, o restante é reembolsado Executar nesta página

Obter chave de API
Meta Vídeo para vídeo #segmentation#mask#real-time

Segmenta e rastreia objetos em um vídeo a partir de prompts de pontos ou caixas, com uma máscara inicial opcional

Meta · Vídeo

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório video_url
Solte um arquivo ou

URL do vídeo para segmentação.

Avançado mask · apply_mask · boundingbox_zip · prompts · box_prompts
mask_url
Solte um arquivo ou

URL da máscara para a aplicação inicial.

padrão []

Prompts usados para segmentação de vídeo.

padrão []

Coordenadas dos limites da caixa.

POST /run/sam2/video?wait=20 cotação → $ 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 esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Segment Anything Model 2 · Video

Segmenta um vídeo com o SAM 2. Oriente-o com `prompts` ou `box_prompts`, ou forneça uma máscara inicial por meio de `mask_url`. `apply_mask` sobrepõe a máscara ao vídeo de saída. Ative `boundingbox_zip` para também receber sobreposições de caixas delimitadoras por quadro em um arquivo zip.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição
video_urlobrigatório video
Tipourl · video
URL do vídeo para segmentação.
mask_urlopcional mask
Tipourl · image
URL da máscara para a aplicação inicial.
promptsopcional
Tipoobject[]
Padrão[]
Prompts usados para segmentação de vídeo.
prompts[].xopcional
Tipointeger
Padrão305
Posição do prompt no eixo X.
prompts[].yopcional
Tipointeger
Padrão350
Posição do prompt no eixo Y.
prompts[].labelopcional
Tipoenum
Padrão1
01
Rótulo do prompt: 1 indica primeiro plano, enquanto 0 indica plano de fundo.
prompts[].frame_indexopcional
Tipointeger
Padrão0
Índice que identifica o quadro para interação.
box_promptsopcional
Tipoobject[]
Padrão[]
Coordenadas dos limites da caixa.
box_prompts[].x_minopcional
Tipointeger
Padrão0
Coordenada x mínima da caixa.
box_prompts[].y_minopcional
Tipointeger
Padrão0
Coordenada y mínima da caixa.
box_prompts[].x_maxopcional
Tipointeger
Padrão0
Coordenada x máxima do prompt.
box_prompts[].y_maxopcional
Tipointeger
Padrão0
Coordenada y máxima do prompt.
box_prompts[].frame_indexopcional
Tipointeger
Padrão0
Índice que identifica o quadro para interação.
apply_maskopcional
Tipoboolean
Padrãofalse
Indica se o mascaramento deve ser aplicado ao vídeo.
boundingbox_zipopcional
Tipoboolean
Padrãofalse
Indica se deve retornar um arquivo ZIP contendo sobreposições das caixas delimitadoras de cada quadro.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
video
object {url, content_type, file_name, file_size}Vídeo produzido pela segmentação.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullArquivo ZIP com sobreposições das caixas delimitadoras de cada quadro.

Mais modelos: Vídeo para vídeo

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/sam2/video.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt