> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan3.0 media download failures: usually the origin is too far from mainland China

> When Wan3.0 returns [InvalidParameter] Failed to download, the model service is fetching your media URL directly. The same 1.5 MB video measured 1.4 MB/s from the US and only 6–11 KB/s from mainland China — right on the 3-minute deadline, which is why the same file is intermittent.

**2026/11/10 23:25 (UTC+8)** · Docs Update

📚 **Wan3.0 media download failures: the file is fine, the path is not**

Several customers reported Wan3.0 video generation intermittently returning `[InvalidParameter] Failed to download https://…`, with the same file sometimes succeeding and sometimes failing. We reproduced it: **the model service fetches the media URL directly from your origin, and reports this error when that fetch times out**. File integrity, API key, and parameters are not involved.

For the same 1.5 MB reference video we measured about 1.4 MB/s from a US node (1.1 s) but only 6–11 KB/s from a mainland China node (150–240 s). The model-side download deadline is on the order of 3 minutes, so the file sits right on the line — hence the intermittent behavior. Larger files fail far more reliably.

**What to do**: host source media on a CDN or object storage in Hong Kong, Singapore, or Japan, keep files under 3 MB, and make sure the URL is publicly reachable and returns a complete `Content-Length`. A mainland China CDN requires an ICP filing, which overseas domains usually do not have.

See the new FAQ for the full diagnostic checklist.

📖 [View details](https://docs.apiyi.com/en/live/2026-11/wan3-media-download-failed-faq)

***

← [Back to Live Updates](https://docs.apiyi.com/en/live.md) · 📚 [Archive by Month](https://docs.apiyi.com/en/live/archive.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.