Avançar 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 com base na utilização real, o restante é reembolsado Executar nesta página

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

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

Meta · Vídeo

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório video_url
Largue um ficheiro ou

URL do vídeo para segmentação.

Avançado mask · apply_mask · boundingbox_zip · prompts · box_prompts
mask_url
Largue um ficheiro ou

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

predefinição []

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

predefiniçã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 este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Segment Anything Model 2 · Video

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

Parâmetros

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

NomeTipo Predefiniçã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[]
Predefinição[]
Prompts utilizados para segmentação de vídeo.
prompts[].xopcional
Tipointeger
Predefinição305
Posição do prompt no eixo X.
prompts[].yopcional
Tipointeger
Predefinição350
Posição do prompt no eixo Y.
prompts[].labelopcional
Tipoenum
Predefinição1
01
Etiqueta do prompt: 1 indica primeiro plano, enquanto 0 indica fundo.
prompts[].frame_indexopcional
Tipointeger
Predefinição0
Índice que identifica o frame da interação.
box_promptsopcional
Tipoobject[]
Predefinição[]
Coordenadas dos limites da caixa.
box_prompts[].x_minopcional
Tipointeger
Predefinição0
Coordenada x mínima da caixa.
box_prompts[].y_minopcional
Tipointeger
Predefinição0
Coordenada y mínima da caixa.
box_prompts[].x_maxopcional
Tipointeger
Predefinição0
Coordenada x máxima do prompt.
box_prompts[].y_maxopcional
Tipointeger
Predefinição0
Coordenada y máxima do prompt.
box_prompts[].frame_indexopcional
Tipointeger
Predefinição0
Índice que identifica o frame da interação.
apply_maskopcional
Tipoboolean
Predefiniçãofalse
Se deve aplicar a máscara ao vídeo.
boundingbox_zipopcional
Tipoboolean
Predefiniçãofalse
Se deve devolver um arquivo ZIP que contenha sobreposições de caixas delimitadoras para cada frame.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
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 de sobreposições de caixas delimitadoras para cada frame.

Mais modelos: Vídeo para vídeo

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