Seedanceで「invalid image format」と表示されるが、ブラウザではリンクが開ける

​

簡潔な回答

The parameter `content[1]` specified in the request is not valid:
invalid image format (detected format); received: "".

​

実際の事例

https://<customer-domain>/api/v1/resource-download-grants/<file-id>/content?access_token=<signed token with an expiry>

​

このようなリンクが存在する理由

• Range 非対応: 多くのサービスでは、フォーマットを検出するためにまず Range ヘッダーで先頭のバイトをリクエストしたり、チャンク単位でダウンロードしたりしてメディアを取得します。このようなエンドポイントはファイル全体しか返さず、Range リクエストに対してエラーを返します
• ダウンロード回数の上限: プロバイダーがメディアを取得する際、プローブ、ダウンロード、失敗時の再試行を行う可能性があり、必ずしも1回だけのダウンロードとは限りません。上限に達すると、レスポンスはエラーの JSON になります
• 短い有効期限: リンクが期限切れになると、レスポンスは画像ではなくなります

​

画像の渡し方の選択

• ファイルがすでにオブジェクトストレージ（OSS、S3、R2など）にある場合は、ストレージサービスから署名付きURLを生成し、その有効期限を少なくとも1時間に設定してください。署名付きURLは時間経過によってのみ失効し、ダウンロード回数の上限はなく、Rangeをサポートしています
• それ以外の場合は、画像を公開オブジェクトストレージバケットまたはCDNにコピーし、新しいURLをSeedanceに渡してください

​

送信前のリンク確認

# 1. Plain download: expect 200 and an image Content-Type such as image/png or image/jpeg
curl -s -o /dev/null -w 'code=%{http_code} type=%{content_type} size=%{size_download}\n' '<URL>'

# 2. Range download: expect 206 (or 200 with the full image), never a 4xx
curl -s -o /dev/null -w 'code=%{http_code} type=%{content_type}\n' -H 'Range: bytes=0-1023' '<URL>'

• 両方のコマンドがJSONやHTMLではなく画像を返すこと
• ダウンロード回数の上限がなく、繰り返しダウンロードが機能し続けること
• Cookie、ログインセッション、追加のヘッダーが不要であること
• 少なくとも送信が完了するまで、理想的には1時間以上リンクが有効であること
• イントラネット内やIP許可リスト配下ではなく、パブリックインターネットからリンクにアクセスできること

​

関連ドキュメント