> ## 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 のダウンロードに失敗しました: ソースメディア URL が失敗する理由と解決方法

> Wan3.0 が [InvalidParameter] Failed to download を返す場合、モデルサービスが渡されたメディア URL の取得に失敗しています。原因はキーではなく、ファイルの破損でもありません。ここでは、国境を越えたネットワーク輻輳、オリジンによる拒否、期限切れリンクを見分ける方法と、ソースメディアを安定してホストする方法を説明します。

## 簡潔な回答

`[InvalidParameter] Failed to download https://…`は、**モデルサービスが渡されたメディアリンクをダウンロードできなかった**ことを意味します。APIYIのゲートウェイ障害ではなく、キーやパラメーター、ファイルの破損が原因でもありません。よくある原因は、**配信元が中国本土から遠すぎる、または通信経路が不安定である**ため、ダウンロードが制限時間内に完了しないことです。

## まず、メディアは当社ではダウンロードしません

API は `input.media[].url` をそのままモデルサービスに転送し、モデルサービスがオリジンから直接ファイルを取得します。そのため、次のようになります。

* 当社のゲートウェイログには、この MP4 のダウンロード記録は残りません。当社側で見つからないのは想定どおりです。
* オリジンの nginx で確認できる取得リクエストは、APIYI のサーバーではなく、モデルサービスのフェッチャーから送信されたものです。

## 3つの原因のどれに該当するか

| 原因 | 典型的な症状 | 簡易確認 |
| - | - | - |
| 国境をまたぐネットワークの混雑またはパケット損失 | 同じファイルが**成功する場合と失敗する場合がある**。失敗には約3分かかる | `curl` 中国本土のノードから URL に対して実行し、スループットとパケット損失を確認します |
| オリジンによる拒否または到達不能 | 数秒から1分以内に速やかに失敗する | リンクをプライベートウィンドウで開き、200 が返るか確認します |
| リンクの期限切れまたは認証が必要 | 以前は動作していたが後から失敗する。または署名パラメータが付いている | リンクを再生成し、セッション Cookie なしで再試行します |

同じファイル（SHA-256 が同一）で成功と失敗の両方が発生している場合は、最初の原因だと判断できます。

## 実測リファレンス

同じ時間帯に、同じ 1.5 MB のリファレンス動画を比較しました。

| 取得場所 | スループット | 1.5 MB の取得時間 |
| - | - | - |
| 米国ノード | 約 1.4 MB/s | 約 1.1 秒 |
| 中国本土ノード | 6–11 KB/s | 150–240 秒 |

モデル側のダウンロード期限は約 3 分（180 秒）です。そのため、1.5 MB はちょうど境界線上にあります。スループットがわずかに良ければ成功し、わずかに悪ければ失敗します。これが、同じファイルで断続的に結果が変わる理由です。より大きなファイルは、はるかに安定して失敗します。

## 解決方法

### 1. ソースメディアを中国本土に近い場所でホストする

優先順位は次のとおりです。

1. **香港、シンガポール、日本**にあるCDNまたはオブジェクトストレージ（越境取得の品質が最も高く、ICP登録も不要です）
2. アジアにPOPがある国際CDN（Cloudflare、Bunny、CloudFrontはいずれも利用できます。香港、シンガポール、東京のいずれかを選んでください）
3. ヨーロッパまたはアメリカからのオリジン直接配信（最も条件が悪く、現在失敗しているケースがまさにこれです）

注：**中国本土のCDNを利用するには、ドメインのICP登録が必要です**。`.ru`や`.com`のような海外ドメインでは通常ICP登録がないため、中国本土のノードは利用できません。実用的な選択肢は香港、シンガポール、日本です。

### 2. メディアサイズを小さくする

10秒の720P参照動画なら、通常は1～2 MBです。ファイルサイズが数十MBある場合は、ビットレートまたは解像度を下げてください。上記の測定結果によると、3 MBを超えるものは時間内に処理が完了しないことがほとんどです。

### 3. リンク自体を確認する

* セッション、Cookie、Refererの許可リストがなくても公開アクセスできること
* 完全な`Content-Length`を返すステータスが200で、`Range`に対応していること
* 有効期限の短い署名付きURLは避けるか、タスクが完了するまで有効であることを確認してください

### 4. 再試行しても効果はありません

再試行しても、さらに3分待つことになるだけです。スループットは変わらないため、成功率は初回と同じです。

## サポートへのお問い合わせが必要な場合

メディアがすでに香港、シンガポール、または日本のノードにあり、3 MB 未満であるにもかかわらず継続的に失敗する場合は、以下をお送りください。

* タスク ID（`task_id`）
* メディアの完全な URL
* 失敗が発生した時刻（タイムゾーン付き）

中国本土のノードから経路を再テストし、モデルプロバイダーにエスカレーションします。


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