リファレンスHTTPステータスコード

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署名が無効または欠落している。
  • ソースはオブジェクトの存在を認識しているが、オブジェクトが存在しない。
  • ソースがオリジンから画像にアクセスするためのパーミッションが誤っている。

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

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

独自プロキシ経由でImgixにリクエストを転送する際のエラー

独自のリバースプロキシ(nginxなど)をImgixの前段に置き、クライアントのリクエストを*.imgix.netサブドメインまたはカスタムドメインに転送している場合、そのプロキシ上で断続的なSSLハンドシェイクの失敗が発生することがあります。例:

peer closed connection in SSL handshake (104: Connection reset by peer) while SSL handshaking to upstream

この場合、Imgixからではなく、お使いのプロキシからクライアントに対して502が返されるのが一般的です。

  • 必ずホスト名にプロキシしてください。解決済みのIPアドレスへのプロキシは避けてください。 Imgixのエッジネットワークは、ホスト名(SNI)に基づいてTLS接続をルーティングします。プロキシがホスト名の代わりにキャッシュされた、または解決済みのIPアドレスに接続していると、そのIPアドレスが後で別のドメインに再割り当てされた際などに接続が拒否・リセットされる可能性があります。
  • TLSハンドシェイク時に正しいホスト名が送信されるようにしてください。nginxの場合は以下を追加します:
    proxy_ssl_server_name on;

Video APIのエラー

422 Can’t Handle MIME Type

  • ソースファイルが音声でも動画でもありません(例:PDF、画像、アーカイブ)。Video APIは音声および動画ソースのみ受け付けます。

424 Failed Dependency

  • source has no video track:音声のみのソースに対して、フレーム生成系の出力形式(fm=mp4、fm=hls、fm=jpg など)がリクエストされました。フレームレスの出力を使用してください:音声は fm=m4a、fm=mp3、fm=wav、トランスクリプトは fm=vtt、ストリームメタデータは fm=json。
  • source has no audio track:ソースにデコード可能な音声ストリームがありません。音声のみの出力(fm=m4a、fm=mp3、fm=wav)には、少なくとも1つの音声トラックを持つソースが必要です。
  • could not probe input media:ファイルは音声または動画として認識されましたが、FFprobeでデコードできませんでした。ファイルが破損または切り詰められている可能性があります。有効なファイルを再アップロードしてください。