# Profundidade de vídeo

> Transforme qualquer vídeo em um vídeo de profundidade, com perto claro e longe escuro, com o Video Depth Anything ou o Depth Anything por quadro.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/video-depth

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
### Adicione o nó
Pressione Tab no canvas e escolha **Vídeo › Continuação e novo estilo › Profundidade de vídeo**.

### Conecte um vídeo
Arraste da saída de um nó de vídeo, como [Enviar vídeo](https://nodaro.ai/docs/nodes/video/upload-video) ou [Gerar vídeo](https://nodaro.ai/docs/nodes/video/generate-video), até a entrada **Vídeo**.

### Escolha o modelo e o visual
Abra o painel de configurações. Escolha um **Provedor**, um **Tamanho do modelo** e um **Mapa de cores**. Mantenha **Escala de cinza** quando o resultado for a entrada de outro nó.

### Execute
Clique em **Executar** no nó. O cartão do nó mostra o vídeo de profundidade, com uma legenda que traz o nome do modelo, por exemplo “Mapa de profundidade · Video Depth Anything”.

Workflow: Um clipe enviado vira um vídeo de profundidade em escala de cinza, com perto claro e longe escuro, e o vídeo de profundidade é salvo.

- Enviar vídeo → Profundidade de vídeo (Vídeo)
- Profundidade de vídeo → Salvar no armazenamento

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Vídeo** | Nós de vídeo | O clipe a transformar em vídeo de profundidade. Obrigatória. A duração dele define o preço, e ele precisa estar dentro do limite do modelo escolhido. |

## Saídas
| Saída | O que leva |
| --- | --- |
| **Vídeo** | O vídeo de profundidade, em MP4. Em **Escala de cinza**, o que está perto fica claro e o que está longe fica escuro. Com **Lado a lado** ativado, o original e a profundidade ficam um ao lado do outro em um só vídeo. |

## Configurações
| Configuração | Padrão | O que faz |
| --- | --- | --- |
| **Provedor** | **Video Depth Anything** | O modelo. O **Video Depth Anything** é estável de um quadro para o outro. O **Depth Anything (por quadro)** processa cada quadro sozinho e pode tremular. |
| **Tamanho do modelo** | **Grande (melhor)** | **Pequeno (mais rápido)**, **Base** ou **Grande (melhor)**. Um tamanho maior dá mais detalhes e é mais lento. |
| **Mapa de cores** | **Escala de cinza** | Como a profundidade é colorida. O Video Depth Anything oferece **Escala de cinza**, **Turbo**, **Inferno**, **Magma** e **Viridis**. O Depth Anything (por quadro) oferece **Escala de cinza** e **Inferno**. |
| **Resolução** | **Automático** | Só no Video Depth Anything. **Automático**, 360p, 480p, 720p ou 1080p. |
| **Lado a lado** | Desativado | Só no Video Depth Anything. Coloca o original e a profundidade um ao lado do outro em um só vídeo. |

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
| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | Depth Anything | Video depth | a partir de 330 | Temporally consistent depth video from any clip. Grayscale or colormapped, up to 2,400 frames or 300 seconds. |
| [Depth Anything (per frame)](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | Depth Anything | Video depth | a partir de 33 | Depth Anything v1 run on each frame. Grayscale or inferno colormap; may flicker between frames. Up to 80 s. |

| Modelo | Entre quadros | Configurações | Clipe mais longo |
| --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | Estável | Todas as cinco | 2.400 quadros e no máximo 300 segundos |
| [Depth Anything (por quadro)](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | Cada quadro sozinho, pode tremular | **Tamanho do modelo**, e **Mapa de cores** em **Escala de cinza** ou **Inferno** | 80 segundos |

## 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.

| Modelo | 15 s | 30 s | 1 min | 2 min | 5 min |
| --- | --- | --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | 330 | 660 | 1.320 | 2.640 | 6.600 |
| [Depth Anything (por quadro)](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | 33 | 66 | 132 | 264 | — |

- **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](https://nodaro.ai/docs/nodes/video/trim-video) 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
| Mensagem ou problema | Causa e solução |
| --- | --- |
| O clipe é recusado por ser longo demais (`video_too_long`). | O clipe é mais longo do que o modelo escolhido aceita. O Video Depth Anything aceita até 2.400 quadros e no máximo 300 segundos, qualquer que seja a taxa de quadros. Um clipe que não informa a taxa de quadros é contado a 30 fps. O Depth Anything (por quadro) aceita até 80 segundos. Corte o clipe e execute de novo. Nenhum crédito é reservado. |
| O clipe é recusado por não poder ser lido (`video_unreadable`). | O Nodaro não conseguiu ler o clipe para medir a duração. Confira se o link leva direto a um arquivo de vídeo, ou envie o arquivo de novo. Nenhum crédito é reservado. |
| A profundidade tremula entre os quadros. | O Depth Anything (por quadro) processa cada quadro sozinho. Escolha o **Video Depth Anything**, que é estável de um quadro para o outro. |
| O mapa de cores escolhido não aparece no resultado. | O modelo não consegue renderizar esse mapa de cores, então a execução usou **Escala de cinza**. O Depth Anything (por quadro) oferece só **Escala de cinza** e **Inferno**. |

## 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`.

```http
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:

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

Na CLI:

```bash
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ó](https://nodaro.ai/docs/developers/api/nodes), a [referência de nós do SDK](https://nodaro.ai/docs/developers/sdk/nodes), os [comandos da CLI](https://nodaro.ai/docs/developers/cli/commands) e as [ferramentas MCP](https://nodaro.ai/docs/mcp/tools).

## Perguntas frequentes

### O que o nó Profundidade de vídeo cria?

O Profundidade de vídeo transforma um vídeo em um vídeo de profundidade do mesmo clipe. Objetos próximos ficam claros e objetos distantes ficam escuros. O resultado é um MP4 que você pode passar para outros nós ou assistir como está.

### Qual modelo escolher no Profundidade de vídeo?

Escolha o Video Depth Anything na maioria dos casos. Ele é estável de um quadro para o outro e oferece todas as configurações. O Depth Anything (por quadro) é mais barato, mas processa cada quadro sozinho, então a profundidade pode tremular, e aceita clipes de até 80 segundos.

### Qual é a duração máxima do vídeo?

O Video Depth Anything aceita até 2.400 quadros e no máximo 300 segundos. Isso dá cerca de 80 segundos a 30 fps. O Depth Anything (por quadro) aceita até 80 segundos. Um clipe mais longo é recusado antes de qualquer reserva de créditos.

### Como é calculado o preço de uma execução do Profundidade de vídeo?

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

### Devo usar escala de cinza ou um mapa de cores?

Mantenha Escala de cinza, o padrão, quando o vídeo de profundidade for a entrada de outro nó. Mapas de cores como Turbo ou Inferno servem para visualizar a profundidade.