Video URL

The Video URL node turns a link to a video's page into a video file that your workflow can use. Paste the link, confirm the content rights declaration for it, and the node downloads the video into your library. Every node you connect receives the video file, not the web page, and the download costs no credits.

When to use it

• Re-edit, caption or analyze a video, or a part of a long one.
• Remix a short clip.
• Use a video from a link as the motion reference for Motion Transfer.
• Take frames from a video with Extract Frame.
• Transcribe the sound of a video with Transcribe, or dub the video with Dubbing.

Quick start

Content rights

Before the node imports a link to a video's page, you confirm the content rights declaration for that link. The declaration says that you hold the rights to the video, or the rights holder's permission, and that you are responsible for how you use it.

• Nothing is fetched from the link until you tick I confirm this declaration for this link. The tick starts the download.
• Read the declaration under the box unfolds its full text.
• A changed link unticks the box.
• Every fetch records your confirmation for the link: the video, its sound, and a download started again.
• The box is never saved with the workflow. Whoever opens the workflow next confirms for themselves.
• A direct link to a video file is passed through, so the node asks nothing.

Imports that your API keys, connected apps and AI agents make have nobody to tick the box. You can authorize those once, in Settings, under Imports through API keys, connected apps and AI agents. See Content rights.

How a link is fetched

Some sites let the node read the length of a video before anything downloads. For those sites, a long video is fetched in parts. Any other link to a video's page is downloaded whole, whatever its length.

Download part of a long video

From and To accept a time such as 1:30, 1:02:03 or a number of seconds. The default part is 0:00 to 1:00.

The clip you get can include a few extra seconds on each side, because the cut follows the keyframes of the video. Add a Trim Video node after it when you need an exact cut.

After a video was downloaded in parts, you can fetch another part of the same link from the settings panel with Download a different part.

Parts for Video Analysis and AI Audit

Video Analysis and AI Audit read up to 10 minutes of video. When the Video URL node is connected straight to one of them, the part chooser shows that limit, and that a part up to 1:00 costs the least.

• Download this part refuses a part longer than 10:00. Choose a shorter part.
• Download whole video is not offered for a video longer than 10:00, or for a video whose length could not be read.

What happens when you run a workflow

A run never uses a link that was not downloaded yet. If a connected Video URL node has no file, the run downloads it first and then starts. The node shows its own progress, and Cancel on the message stops the wait, while the download itself carries on.

Three cases stop the run with a message that names the node:

• The content rights box is not ticked for the link. Tick it in the node, and run again.
• A long video, from a site whose length is read first, with no part chosen. Choose a part, or the whole video, and run again.
• A download that failed. The message says why.

When a part must be chosen, the message gives the length of the video, when it is known. If the node feeds Video Analysis or AI Audit, the message also says that a part up to 1:00 costs the least. For a video longer than 10:00, it names the limit, for example "Video Analysis reads up to 10:00". Click Show on the message to select the Video URL node and open its settings panel, where you tick the box or choose the part. The message stays on screen for 20 seconds.

A run fetches only what it needs:

• A Video URL node that is not connected to anything in the run is left alone.
• Transcribe and Suno Cover use only the sound of the link. When they are the only nodes that read it, the run never waits for the video download. When the node has no sound yet, because the box was not ticked when the link was pasted or that fetch failed, the run fetches the sound first, under the same box.
• Dubbing dubs the video, so the run downloads the video first. A Dubbing node with its own Source Link dubs that link instead, and the run downloads nothing for it.

Opening a workflow never starts a download. A node that was downloading when you closed the page picks up that same download if it is still running. Otherwise the node shows Download Video again, behind the box.

Output

The output, Video, is the downloaded file, or the direct file link that you pasted. The node also fetches the sound of the link in the background, once the box is ticked, and Suno Cover and Transcribe use it when they are connected.

When a download fails

The node shows one of these messages. Hover the message to see the site's own wording.

Click Retry Download to try again after you fix the cause.

Credits and storage

The Video URL node costs no credits. The downloaded file counts toward your storage, so delete it from your library when you no longer need it.

Use it as an app input

You can choose a Video URL node as an input of a published app. The app's user then pastes a link to their own video instead of uploading a file.

On the app's page, a link to a video's page shows the content rights box under the field. The app's user ticks the box for their link, and a changed link unticks it. The link is then downloaded in the field before Launch, with the same rules as on the canvas. A long video from a site whose length is read first asks for a part. Any other web link is used as it is.

• When only Transcribe or Suno Cover read the link, nothing is downloaded in the field. Launch waits for the tick, and the server fetches the sound when the app runs.
• When only Content Recipe reads the link, nothing is imported, and no box is shown. Content Recipe cites the page.
• Dubbing dubs the file, so a link that Dubbing reads is downloaded in the field, like a link that a node watches.

Over MCP, the SDK and the API, the app input is a link too. The server downloads the link before the first node runs, with the same rules. A long video from a site whose length is read first is downloaded only as a part that you name, as described in the next section.

Tips

• Sound only. For only the sound, the Reference Audio node extracts it from some links.
• Choose a short part. A short part downloads faster, and every node after it processes less video.
• Use videos you may use. Import only videos that you hold the rights to, or have the rights holder's permission for. That is what the box confirms.

From the API

A workflow written through the API or by an AI assistant carries only the link. A run started from the API, MCP or the SDK downloads the link before the first node runs, when a node after it needs the file. The link can be saved in the workflow or set in the run's inputOverrides. The rules are the same as in the editor:

• From a site whose length is read first, a video of 4 minutes or longer, or of unknown length, is downloaded only as a part. Name the part in seconds with sectionStartSec and sectionEndSec, on the node or in inputOverrides.
• Without a part, the run is refused before any node runs and before anything is charged.
• The fetch is an import of the link. Send the content rights confirmation for that link and that run as the node's rightsConfirmationId in inputOverrides, from POST /v1/content-rights/confirm. One confirmation opens one download within an hour, so it is never saved on the node. Whether a run without one is refused is a setting of the deployment. See Content rights.

The downloaded file is kept with that run. A Render final after the run uses the same file and does not download it again. A repeated run downloads the video again, and the file is not saved back to the node.

To download a video yourself first, import it with POST /v1/download-video. Then put the returned file URL in an Upload Video node, or in the Video URL field of this node. A direct file link passes through that field without a download. See Voice and media.