HTTPステータスコードの概要

画像リクエストでエラーコードが返された場合は、以下にその意味と考えられる原因を記載しています。

このページに記載されていないエラーが発生した場合は、お気軽にサポートまでご連絡ください。

また、進行中のインシデントについてはステータスページもご覧いただけます。

Rendering APIのエラー

400 Bad Request

• Web Proxy Sourceから画像がリクエストされ、プロキシ対象のURLが絶対URLでない。
• Web Proxy Sourceから無効なホスト名で画像がリクエストされている。
• ソースに設定されたデフォルトパラメータが問題を引き起こしている。
  • 同じソース内の画像を参照するmarkやblendを使用すると、ループが発生します。markやblendを使用する場合は、別のソース内の画像を参照するようにしてください。
• base64パラメータを使っているが、base64エンコードされていない場合は400レスポンスが返されます。
• base64エンコード文字列がURLセーフでない。+を-に、/を_に置き換え、末尾の=を削除してください。詳しくはこちらをご覧ください。

402 Billing Error

• アカウントに支払いに関する問題があります。ダッシュボードにログインして、問題を確認・解決してください。
• 未払いの請求書があります。
• プランの上限を超えており、上位プランへのアップグレードが必要です。

403 Forbidden

• Secure URLオプションが有効なソースから画像がリクエストされ、s署名が無効または欠落している。
  • ソース設定でSecure URLを無効にするか、ダッシュボードツールを使って画像に署名してください。
• ソースはオブジェクトの存在を認識しているが、オブジェクトが存在しない。
• ソースがオリジンから画像にアクセスするためのパーミッションが誤っている。

404 Not Found

• オリジンから画像にアクセスできません。以下を確認してください：
  • Imgixソース設定で画像へのファイルパスが正しいか
  • S3ソースを使用している場合、Imgixに入力したS3のAccess KeyおよびAccess Key IDが有効で、IAMユーザーにオブジェクトにアクセスする権限があるか
  • Imgixが画像にアクセス可能で、ブロックリストに登録されていないか
  • オリジンのHTTPS証明書が有効かつ正常に動作しているか

410 bad_source

• ソースがデプロイされていない状態で画像がリクエストされている。
  • ソースが実際にデプロイされているか確認してください。
• ドメインに該当URLのホスト名が含まれていないソースから画像がリクエストされている。

413 Request Entity Too Large

• リクエストされた画像が大きすぎます。現在の入力制限は500MBです。

414 URI Too Long

• URIが長すぎます。現在の制限は8000文字です。
• 一部ブラウザの制限により、最大2048文字の使用を推奨します。

421 Misdirected Request

• リクエストされた画像が内部検証に失敗しました。通常は破損した画像が原因です。

422 Precondition failed

• 非レンダリング画像（例：HTMLファイル）を配信しようとしています。有料プランをご利用の場合は、サポートへご連絡いただければ、非レンダリングアセットの配信を有効にできます。
• クエリ文字列内のパラメータに無効な値が含まれています（例：w=0）。
• 画像（またはウォーターマーク/ブレンド）が処理できない
  • ファイルタイプまたはファイル破損が原因です。ローカルに画像を保存し、ImageMagickのコマンドラインツールを使って確認できます。以下のコマンドで診断してください： +++ magick identify -verbose image_name.png +++
• mark/blendのURLにSVGを使用しているが、該当ソースでSVGレンダリングが有効になっていない
• カラープロファイルが画像に存在しない可能性があります（画像のメタデータを確認してください）
• 処理中のGIFがフレーム数または各フレームのサイズが大きすぎる

423 Locked

• アセットが処理中で、まだ利用できません。数秒待ってから再試行してください。
  • AI変換リクエストを連鎖的に実行すると発生する場合があります。

424 Failed Dependency

• オリジンから画像の取得中にエラーが発生しました。（例：オリジンでの5xxエラー）

429 Too Many Requests

• レンダリングのレート制限を超えました。数秒待ってから再試行してください。
• 頻繁に発生する場合は、アカウントマネージャーまたはサポートへご連絡ください。

500 Internal Server Error

• 画像の処理中にエラーが発生しました。

503 Service Unavailable

• 処理要件による一時的な利用不可状態。例：リクエストされたGIFが大きすぎる。

504 Gateway Timeout

• オリジンからオブジェクトを取得中にタイムアウトが発生しました。