Profundidade de vídeo

O nó Profundidade de vídeo transforma um vídeo em um vídeo de profundidade: o que está perto fica claro e o que está longe fica escuro. Ele estima a profundidade de cada quadro e a renderiza como um MP4 do mesmo clipe. Passe o resultado em escala de cinza para uma geração guiada por profundidade, uma mudança de iluminação ou uma composição, ou escolha um mapa de cores para um visual estilizado.

Quando usar

• Você precisa de um passe de profundidade de um clipe para composição, por exemplo para colocar uma camada entre o primeiro plano e o fundo.
• Você quer um vídeo de profundidade como guia para outra geração ou para uma mudança de iluminação.
• Você quer um visual de profundidade estilizado, como um mapa de cores Turbo ou Inferno, para um título ou um clipe de rede social.
• Você quer comparar o clipe original e a profundidade dele lado a lado.

Início rápido

Entradas

Saídas

Configurações

O painel de configurações mostra só as configurações que o modelo escolhido aceita. Uma configuração que o modelo não aceita é ignorada, e um mapa de cores que o modelo não consegue renderizar vira Escala de cinza. A execução nunca é recusada por isso, então um modelo trocado por um mapeamento de campo continua funcionando.

Modelos

Créditos

O preço depende do modelo e da duração do clipe de entrada. A duração é arredondada para cima até a próxima faixa: 15 segundos, 30 segundos, 1 minuto, 2 minutos ou 5 minutos.

• Como a faixa é escolhida. Um clipe de 5 segundos e um de 15 segundos ficam na faixa de 15 s. Um clipe de 15,01 segundos fica na faixa de 30 s, e um clipe de 61 segundos fica na faixa de 2 min.
• O clipe é medido antes da execução. Um clipe que não pode ser lido é recusado antes de qualquer reserva de créditos. Uma execução nunca tem o preço calculado por uma duração estimada.
• O preço no nó. Enquanto a duração de um vídeo conectado não é conhecida, o nó mostra a faixa de 15 s. O preço é atualizado quando um vídeo com duração conhecida é conectado.
• Depth Anything (por quadro). Este modelo aceita clipes de até 80 segundos, então a faixa de 2 min é o máximo que uma execução pode custar.

Dicas

• Mantenha Escala de cinza para outros nós. A escala de cinza funciona melhor como entrada de outro nó. Mapas de cores servem para visualizar.
• Teste com Pequeno, finalize com Grande. Use Pequeno (mais rápido) para conferir um clipe rápido e Grande (melhor) para a versão final.
• Corte antes. O preço segue a duração do clipe de entrada. Corte o clipe até a parte que você precisa com o Cortar vídeo antes do Profundidade de vídeo.
• Escolha o Video Depth Anything para tomadas com movimento. O Depth Anything (por quadro) processa cada quadro sozinho, então a profundidade pode tremular entre os quadros.

Solução de problemas

Pela API

POST /v1/video-depth recebe videoUrl, com provider, modelSize, colormap, resolution e sideBySide opcionais. provider é video-depth-anything (o padrão) ou depth-anything-frames, e modelSize é small, base ou large (o padrão). colormap é grayscale, turbo, inferno, magma ou viridis, e resolution é auto, 360p, 480p, 720p ou 1080p.

POST /v1/video-depth
Content-Type: application/json

{
  "videoUrl": "https://example.com/clip.mp4",
  "provider": "video-depth-anything",
  "modelSize": "large",
  "colormap": "grayscale"
}

A resposta é { jobId }, e a saída da tarefa concluída é { videoUrl, thumbnailUrl }. Uma configuração que o modelo não aceita é ignorada, e um mapa de cores que ele não consegue renderizar vira grayscale. Um valor fora das listas acima é um 400 validation_error. O clipe é medido antes de qualquer coisa ser criada: 400 video_too_long e 400 video_unreadable não reservam nada.

No SDK, execute o nó pelo tipo dele:

const result = await client.nodes.run("video-depth", {
  videoUrl: "https://example.com/clip.mp4",
  colormap: "grayscale",
})

Na CLI:

nodaro nodes run video-depth --param videoUrl=https://example.com/clip.mp4 --watch

Em um assistente de IA, a ferramenta MCP é video_depth, com video_url ou video_asset_id e os opcionais provider, model_size, colormap, resolution e side_by_side. Veja Executar um único nó, a referência de nós do SDK, os comandos da CLI e as ferramentas MCP.