簡潔な回答
[InvalidParameter] Failed to download https://…は、モデルサービスが渡されたメディアリンクをダウンロードできなかったことを意味します。APIYIのゲートウェイ障害ではなく、キーやパラメーター、ファイルの破損が原因でもありません。よくある原因は、配信元が中国本土から遠すぎる、または通信経路が不安定であるため、ダウンロードが制限時間内に完了しないことです。
まず、メディアは当社ではダウンロードしません
API はinput.media[].url をそのままモデルサービスに転送し、モデルサービスがオリジンから直接ファイルを取得します。そのため、次のようになります。
- 当社のゲートウェイログには、この MP4 のダウンロード記録は残りません。当社側で見つからないのは想定どおりです。
- オリジンの nginx で確認できる取得リクエストは、APIYI のサーバーではなく、モデルサービスのフェッチャーから送信されたものです。
3つの原因のどれに該当するか
同じファイル（SHA-256 が同一）で成功と失敗の両方が発生している場合は、最初の原因だと判断できます。
実測リファレンス
同じ時間帯に、同じ 1.5 MB のリファレンス動画を比較しました。
モデル側のダウンロード期限は約 3 分（180 秒）です。そのため、1.5 MB はちょうど境界線上にあります。スループットがわずかに良ければ成功し、わずかに悪ければ失敗します。これが、同じファイルで断続的に結果が変わる理由です。より大きなファイルは、はるかに安定して失敗します。
解決方法
1. ソースメディアを中国本土に近い場所でホストする
優先順位は次のとおりです。- 香港、シンガポール、日本にあるCDNまたはオブジェクトストレージ（越境取得の品質が最も高く、ICP登録も不要です）
- アジアにPOPがある国際CDN（Cloudflare、Bunny、CloudFrontはいずれも利用できます。香港、シンガポール、東京のいずれかを選んでください）
- ヨーロッパまたはアメリカからのオリジン直接配信（最も条件が悪く、現在失敗しているケースがまさにこれです）
.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
- 失敗が発生した時刻（タイムゾーン付き）