# URL de vídeo

> Transforme links do YouTube, TikTok, Instagram, Facebook e X em arquivos de vídeo para cortar, legendar, analisar e remixar. Baixe parte de vídeos longos.

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

O nó **URL de vídeo** (Video URL) transforma o link de um vídeo de rede social em um arquivo de vídeo que o seu workflow pode usar. Cole um link do YouTube, TikTok, Instagram, Facebook ou X, e o nó baixa o vídeo para a sua biblioteca. Todo nó que você conectar recebe o arquivo de vídeo, não a página da web, e o download não custa créditos.

- Found in: Automate › Get Content
- Output: video
- API type: `youtube-video`

## Quando usar
- Reeditar, legendar ou analisar um vídeo do YouTube, ou uma parte dele.
- Remixar um vídeo do TikTok ou um Reel do Instagram.
- Usar um vídeo de rede social como referência de movimento para [**Transferir movimento** (Motion Transfer)](https://nodaro.ai/docs/nodes/video/motion-transfer).
- Tirar quadros de um vídeo com [**Extrair quadro** (Extract Frame)](https://nodaro.ai/docs/nodes/image/extract-frame).
- Transcrever ou dublar o som de um vídeo com [**Transcrever** (Transcribe)](https://nodaro.ai/docs/nodes/audio/transcribe) ou [**Dublagem** (Dubbing)](https://nodaro.ai/docs/nodes/audio/dubbing).

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Automatizar › Coleta de conteúdo › URL de vídeo**. O nó também fica nas abas **Comuns** e **Vídeo**, ao lado dos nós de envio.

### Colar o link
Cole o link no nó ou em **URL do vídeo**, no painel de configurações. O download começa sozinho, e o nó mostra o progresso.

### Escolher uma parte de um vídeo longo do YouTube
Para um vídeo do YouTube de 4 minutos ou mais, o nó mostra a duração do vídeo e pergunta o que baixar. Defina **De** e **Até** e clique em **Baixar esta parte**, ou clique em **Baixar o vídeo inteiro**. Quando o nó alimenta a [**Análise de vídeo** (Video Analysis)](https://nodaro.ai/docs/nodes/video/video-analysis) ou a [**Auditoria com IA** (AI Audit)](https://nodaro.ai/docs/nodes/video/ai-audit), ele também mostra até que duração uma parte pode ter.

### Conectar o vídeo
Conecte a saída **Vídeo** ao próximo nó, como [**Cortar vídeo** (Trim Video)](https://nodaro.ai/docs/nodes/video/trim-video) ou [**Adicionar legendas** (Add Captions)](https://nodaro.ai/docs/nodes/video/add-captions).

Workflow: Uma parte de um vídeo do YouTube é baixada, cortada com precisão no nó Cortar vídeo e legendada.

- URL de vídeo → Cortar vídeo
- Cortar vídeo → Adicionar legendas

## Como um link é obtido
| Link | O que acontece |
| --- | --- |
| TikTok, Instagram, Facebook ou X | O vídeo inteiro é baixado assim que você cola o link. |
| YouTube, com menos de 4 minutos | O vídeo inteiro é baixado assim que você cola o link, em até 1080p. |
| YouTube, com 4 minutos ou mais, ou de duração desconhecida | O nó mostra a duração e pergunta: **Baixar esta parte** ou **Baixar o vídeo inteiro**. Nada é baixado até você escolher. |
| Transmissão ao vivo do YouTube | Ela não pode ser baixada. Tente de novo depois que a transmissão terminar. |
| Link direto para um arquivo de vídeo (`.mp4`, `.webm`, `.mov`, `.avi`) | O link passa adiante como está. Nada é baixado. |

## Baixar parte de um vídeo longo do YouTube
**De** e **Até** aceitam um tempo como `1:30`, `1:02:03` ou um número de segundos. A parte padrão vai de `0:00` a `1:00`.

O clipe que você recebe pode incluir alguns segundos a mais em cada ponta, porque o corte segue os quadros-chave do vídeo. Adicione um nó [Cortar vídeo](https://nodaro.ai/docs/nodes/video/trim-video) depois dele quando precisar de um corte exato.

Depois do download, você pode buscar outra parte do mesmo link no painel de configurações, com **Baixar outra parte**.

### Partes para a Análise de vídeo e a Auditoria com IA
A [Análise de vídeo](https://nodaro.ai/docs/nodes/video/video-analysis) e a [Auditoria com IA](https://nodaro.ai/docs/nodes/video/ai-audit) leem até 10 minutos de vídeo. Quando o nó URL de vídeo está conectado diretamente a uma delas, a escolha da parte mostra esse limite e avisa que uma parte de até 1:00 custa menos.

- **Baixar esta parte** recusa uma parte com mais de 10:00. Escolha uma parte mais curta.
- **Baixar o vídeo inteiro** não aparece para um vídeo com mais de 10:00, nem para um vídeo cuja duração não pôde ser lida.

## O que acontece quando você executa um workflow
Uma execução nunca usa um link que ainda não foi baixado. Se um nó URL de vídeo conectado não tem arquivo, a execução primeiro faz o download e depois começa. O nó mostra o próprio progresso, e **Cancelar**, na mensagem, interrompe a espera, mas o download em si continua.

Dois casos interrompem a execução com uma mensagem que cita o nó:

- Um vídeo longo do YouTube sem nenhuma parte escolhida. Escolha uma parte, ou o vídeo inteiro, e execute de novo.
- Um download que falhou. A mensagem diz o motivo.

Quando é preciso escolher uma parte, a mensagem informa a duração do vídeo, quando ela é conhecida. Se o nó alimenta a Análise de vídeo ou a Auditoria com IA, a mensagem também avisa que uma parte de até 1:00 custa menos. Para um vídeo com mais de 10:00, ela indica o limite, por exemplo “Análise de vídeo lê até 10:00”. Clique em **Mostrar** na mensagem para selecionar o nó URL de vídeo e abrir o painel de configurações dele, onde você escolhe a parte. A mensagem fica na tela por 20 segundos.

Uma execução só busca o que precisa:

- Um nó URL de vídeo que não está conectado a nada na execução fica de fora.
- [Transcrever](https://nodaro.ai/docs/nodes/audio/transcribe), [**Cover com Suno** (Suno Cover)](https://nodaro.ai/docs/nodes/audio/suno-cover) e [Dublagem](https://nodaro.ai/docs/nodes/audio/dubbing) usam só o som do link. Quando eles são os únicos nós que leem o link, a execução nunca espera o download do vídeo.

Abrir um workflow nunca inicia um download. Um nó que estava baixando quando você fechou a página retoma esse mesmo download, se ele ainda estiver em andamento. Caso contrário, o nó volta a mostrar **Baixar vídeo**.

## Saída
A saída, **Vídeo**, é o arquivo baixado ou o link direto de arquivo que você colou. O nó também busca o som do link em segundo plano, e os nós [Cover com Suno](https://nodaro.ai/docs/nodes/audio/suno-cover) e [Transcrever](https://nodaro.ai/docs/nodes/audio/transcribe) usam esse som quando estão conectados.

## Quando um download falha
O nó mostra uma destas mensagens. Passe o mouse sobre a mensagem para ver o texto do próprio site.

| Mensagem | O que significa |
| --- | --- |
| O vídeo chegou sem o som | O site enviou uma cópia sem som. Tente de novo daqui a pouco. Se o vídeo realmente não tem som, escolha **Baixar sem som**. |
| Este vídeo é privado | Peça ao proprietário para torná-lo público. |
| Este vídeo tem restrição de idade | Ele não pode ser baixado. |
| Este vídeo não está disponível na região de onde fazemos o download | O site bloqueia o vídeo por localização. |
| A conexão caiu durante o download | Tente de novo. O download pode já ter terminado, e a nova tentativa o recupera. |
| Há muitos downloads em andamento ao mesmo tempo | Uma conta pode fazer 4 downloads de cada vez. Aguarde um terminar e tente de novo. |
| Não foi possível obter este vídeo | Confira se o link abre em uma janela anônima do navegador. |

Clique em **Tentar baixar novamente** para tentar de novo depois de corrigir a causa.

## Créditos e armazenamento
O nó URL de vídeo não custa créditos. O arquivo baixado conta no seu armazenamento, então exclua-o da sua biblioteca quando não precisar mais dele.

## Dicas
- **Só o som.** Para usar só o som de um vídeo do YouTube, use o nó [**Áudio de referência** (Reference Audio)](https://nodaro.ai/docs/nodes/audio/reference-audio) em vez deste.
- **Escolha uma parte curta.** Uma parte curta é baixada mais rápido, e cada nó seguinte processa menos vídeo.
- **Use vídeos que você pode usar.** Baixe só vídeos que você tem o direito de usar.

## Pela API
Um nó URL de vídeo só recebe o arquivo quando o editor faz o download. Um workflow escrito pela API ou por um assistente de IA guarda só o link, e uma execução iniciada pela API não faz o download. Para usar um vídeo de rede social nesse tipo de workflow, importe-o antes com `POST /v1/download-video`. Depois, coloque a URL do arquivo retornado em um nó [**Enviar vídeo** (Upload Video)](https://nodaro.ai/docs/nodes/video/upload-video) ou no campo **URL do vídeo** deste nó. Um link direto de arquivo passa por esse campo sem download. Veja [Voz e mídia](https://nodaro.ai/docs/developers/api/voice-and-media).

## Frequently asked questions

### Quais sites o nó “URL de vídeo” aceita?

YouTube, TikTok, Instagram, Facebook e X. Um link direto para um arquivo de vídeo terminado em .mp4, .webm, .mov ou .avi também funciona e passa adiante sem download.

### O nó “URL de vídeo” custa créditos?

Não. Baixar um vídeo é grátis. O arquivo baixado conta no seu armazenamento, então exclua-o da sua biblioteca quando não precisar mais dele.

### Como uso só uma parte de um vídeo longo do YouTube?

Para um vídeo do YouTube de 4 minutos ou mais, o nó pergunta o que baixar. Defina “De” e “Até”, por exemplo 1:30 e 2:30, e clique em “Baixar esta parte”. O clipe pode incluir alguns segundos a mais em cada ponta, então adicione o nó “Cortar vídeo” para um corte exato.

### Por que o download do meu vídeo falhou?

O nó mostra o motivo. Os mais comuns são um vídeo privado ou com restrição de idade, um vídeo bloqueado na região de onde o Nodaro faz o download e mais de 4 downloads em andamento ao mesmo tempo na sua conta. Passe o mouse sobre a mensagem para ver o texto do próprio site.

### Um workflow iniciado pela API pode baixar o link de um nó “URL de vídeo”?

Não. Uma execução iniciada pela API não baixa links. Importe o vídeo antes com POST /v1/download-video e coloque a URL do arquivo retornado em um nó “Enviar vídeo” ou no campo “URL do vídeo”.