> ## 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 / HappyHorse 素材下载失败：图片可直接传 base64

> Wan3.0 与 HappyHorse 的图片素材支持 base64 data URI，原厂不再回源下载，可绕过跨洲抓取超时。实测 1.1 MB JPEG 成功，附提交耗时与防重复计费提醒。

**2026/11/18 21:46 (UTC+8)** · 文档更新 · Alibaba

📖 **Wan3.0 / HappyHorse 素材下载失败：图片可直接传 base64**

原厂抓取公网图片超时会报 `[InvalidParameter] Failed to download`，这类失败与密钥、文件完整性无关，通常是源站到中国大陆的链路太慢。现在 `first_frame` / `last_frame` / `reference_image` 支持 `data:image/jpeg;base64,...`，图片随请求体提交，原厂不再回源，可绕过抓取超时。

实测 `wan3.0-video` 传 1.1 MB JPEG 的 data URI 任务正常完成。注意 base64 提交会慢一些（约 1 MB 需 110 秒），客户端超时请设 300 秒以上；超时后不要盲目重试，任务可能已创建，重试会重复计费。完整排查步骤与代码示例见 [素材下载失败 FAQ](https://docs.apiyi.com/faq/wan3-media-download-failed.md)。

***

← [返回实时动态](https://docs.apiyi.com/live.md) · 📚 [按月归档](https://docs.apiyi.com/live/archive.md)


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