# Reference materials

https://video-doc.1route.dev/en/docs/materials



## A directly downloadable URL [#a-directly-downloadable-url]

WAN3 accepts JSON with HTTPS media URLs. A computer file path is not an upload.

Try opening the URL without signing in. It should return the image, video or audio itself, not a sign-in or preview page. This is only an initial check: clients should verify an actual download, not just HEAD.

## Local files [#local-files]

Use storage you or your team trusts, then copy the file URL. Private storage can use signed URLs that remain valid during the entire queue and generation period. If you have no storage, start with text-only video and ask your AI to help set up media hosting.

This documentation does not upload or publish customer files.

## Unsupported addresses [#unsupported-addresses]

Local paths, file: URLs, blob: URLs, private-network addresses and share pages requiring a password or download-button click cannot be used as public media URLs.

Keep signed query parameters unchanged. Do not delete files while the task is waiting or running.

## Media fields [#media-fields]

Prefer reference\_images, reference\_videos and reference\_audios as documented in the [API guide](/en/docs/api/). These are arrays of objects, not arrays of strings.

The documented image limit is 10. Use only necessary inputs. Image roles include first\_frame and last\_frame. Audio reference does not guarantee an audio track in every output.

Only video families accept video references, with explicit duration and the [duration limits](/en/docs/models/).

## Read-image timeouts [#read-image-timeouts]

A failed image download may be due to a slow host, expired URL, anti-hotlink protection or service-to-service networking. The error alone does not establish fault. Check the URL and preserve the request ID.