メインコンテンツへスキップ

画像メタデータを取得する n8n

このノードの機能

PDF4me - 画像メタデータを取得する 画像の技術的特性を読み取ります n8n ワークフローを実行し、フォーマット、幅、高さ、DPI、ピクセルあたりのビット数、方向、および構造化データとして返します。 EXIF カメラデータが存在する場合。出力を使用して、画像品質チェックのゲート、アセットプロパティのデータベースへのログ記録、サイズ超過画像のリサイズステップへのルーティング、またはアップロードされた写真が保存前に公開仕様を満たしていることの検証を行います。バイナリデータを受け入れます。 Base64 文字列、またはパブリック URLs.

関連ブログ記事
この機能に関するブログ記事はまだありません。近日公開予定です。
その間、PDF4me ブログを閲覧して、あらゆるプラットフォームのチュートリアルやワークフローをご覧ください。
ブログをご覧ください →

認証 API リクエスト​

毎 PDF4me ノード n8n 有効な 資格. お客様の情報を保持する資格情報を作成または選択します PDF4me API ノードが画像解析リクエストを安全に認証できるようにするためのキー。

見逃してはならない重要な事実​

画像タイプは実際のフォーマットと一致している必要があります
画像タイプを設定 JPEG、 PNG指定した画像の実際の形式に一致するように、GIF または BMP を指定してください。画像タイプの値と実際の形式が一致しない場合、ノードがエラーまたは誤ったメタデータを返す可能性があります。形式が不明な場合は、ファイル拡張子または を確認してください。 MIME このパラメータを設定する前に、前のノードから型を取得してください。
hasExifDataは、exifDataが安全に使用できるかどうかを示します。
画像にデータが埋め込まれていない場合、exifData フィールドは null になります。 EXIF メタデータ - プログラムで生成された画像、スクリーンショット、エクスポートされたグラフィックに共通。exifData フィールドをダウンストリーム ノードにマッピングする前に、必ず hasExifData ブール値を最初に確認してください。null オブジェクトのサブ フィールドにアクセスしようとすると、 n8n 実行が失敗しました。
解像度はピクセルではなくDPIで表されます。
horizontalResolutionとverticalResolutionは、ピクセルではなく、1インチあたりのドット数(DPI)で返されます。一般的なWeb画像では、72または96 DPIが返されます。印刷品質の画像は、300 DPI以上である必要があります。これらのフィールドを使用して、品質チェックワークフローで画像をフィルタリングできます。たとえば、印刷用に200 DPI未満の画像を拒否し、再アップロード要求ステップにルーティングできます。
n8n PDF4me Get Image Metadataノードでは、入力データタイプがバイナリデータ、入力バイナリフィールドがデータ、出力ファイル名がimage_metadata.json、画像タイプがPNG、非同期がfalseに設定されています。

入力データタイプと画像タイプを画像ソースに合わせて設定し、出力ファイル名に拡張子「.json」を付けて入力し、実行してください。すべてのメタデータフィールドはノード出力に表示されます。

パラメータ​

必須: 入力データタイプ、そのタイプに一致する画像ソースフィールド(入力バイナリフィールド、 Base64 画像コンテンツ、または画像 URL出力ファイル名、および画像タイプ。 Async 任意です。

パラメータ必須その機能例
Input Data TypeRequiredChoose how to provide the image file to extract metadata from. Options: Binary Data, Base64 String, URL. Default is `Binary Data`.Binary Data
Input Binary FieldConditionalName of the binary property that contains the image file. Shown when Input Data Type is Binary Data. Default is `data`.data
Base64 Image ContentConditionalBase64 encoded image content. Shown when Input Data Type is Base64 String./9j/4AAQS...
Image URLConditionalURL to the image file to extract metadata from. Shown when Input Data Type is URL.https://example.com/photo.png
Output File NameOptionalNot used for the output (no file is returned); only sent to PDF4me as the document name when the image is given as Base64. Default is `image_metadata.json`.image_metadata.json
Image TypeRequiredType of the image. Options: JPG, PNG. Default is `PNG`.PNG
AsyncOptionalNot used: the node always sends the request to PDF4me as asynchronous (IsAsync true), whatever this is set to. Default is `Yes`.Yes

出力フィールド​

分野タイプ内容物
_metadataStringObject added by the node: success (true), message, processingTimestamp (time of processing, ISO format), sourceFileName (name of the input image), operation (always `getImageMetadata`) and imageType (Image Type selected).

すべての分野 PDF4me GetImageMetadataの応答(画像メタデータ)は、そのままアイテムにコピーされます。

すべての分野の PDF4meGetImageMetadata の応答 (画像メタデータ) は、そのままアイテムにコピーされます。

クイックセットアップ​

  1. 追加する PDF4me ノードを選択して選択する 画像メタデータを取得する。
  2. 選択または作成する 資格 あなたの PDF4me API 鍵。
  3. セット 入力データタイプ 画像ソース (バイナリ、 Base64、 または URL)
  4. セット 画像タイプ 画像の実際のフォーマットに合わせるため。
  5. 入力 出力ファイル名 と .json 拡張機能をクリックしてクリック Node.jsを実行する地図 width、 height、 horizontalResolution、 そして hasExifData 下流ノードへ。

ワークフローの例​

ワークフローの例Common n8n workflow patterns using Get Image Metadata.
画像解像度によるゲートプリントジョブ
  1. デザイナーが印刷用の画像をアップロードすると、フォーム送信がトリガーされます。
  2. 画像メタデータ取得機能は、アップロードされたファイルからhorizontalResolutionとverticalResolutionを読み取ります。
  3. IFノードは、両方の値が300 DPI以上であるかどうかをチェックします。
  4. 合格した画像はAirtableの印刷キューに送られます。不合格となった画像は、デザイナーに高解像度での再アップロードを求めるSlackメッセージが送信されます。
デジタル資産を完全なメタデータとともにデータベースにカタログ化する
  1. Dropboxの監視フォルダは、「アセット取り込み」フォルダに新しい画像が配置されたときにトリガーされます。
  2. 画像メタデータの取得により、すべてのプロパティが抽出されます。 EXIF カメラデータが存在する場合。
  3. PostgresまたはAirtableノードは、ファイル名、寸法、フォーマット、DPI、および EXIF 資産カタログに取得された日付。
  4. アセットは「カタログ化済み」フォルダに移動され、Slackメッセージで新しいエントリが追加されたことが確認されます。
サイズが大きすぎる画像は、公開前にサイズ変更ステップにルーティングする。
  1. 1 HTTP ウェブフックは、ECサイトのアップロードフォームから商品画像を受信します。
  2. 画像メタデータ取得関数は、各画像の幅と高さを返します。
  3. IFノードは、4000ピクセルを超える幅の画像を、保存前に圧縮画像またはサイズ変更ステップにルーティングします。
  4. サイズが適切な画像は、サイズ変更の手順をスキップして、直接製品CDNへのアップロードに進みます。

よくある質問​

What metadata does this node return exactly?+
The node returns imageFormat (Jpeg/Png/Gif/Bmp), fileSize in bytes, width and height in pixels, orientation (Portrait/Landscape/Square/null), bitsperPixel (color depth), horizontalResolution and verticalResolution in DPI, hasExifData boolean, exifData object (camera make/model, GPS, timestamps - or null if absent), hasXmpData boolean, and a _metadata processing summary. All fields are available as individual mapped outputs in downstream n8n nodes.
Why do I need to set Image Type separately if PDF4me can detect the format?+
Image Type tells the PDF4me API which decoder to use for the initial parse, which improves accuracy and speed - especially for edge cases where file headers are incomplete or the binary is embedded in a Base64 string with no MIME type context. The imageFormat output field then confirms the actual detected format after processing.
How do I check if EXIF data is present before using it?+
Map the hasExifData output into an IF node condition. When hasExifData is true, route to a branch that maps exifData sub-fields (such as exifData.DateTimeOriginal or exifData.GPSLatitude). When false, skip that branch or substitute a default value. Attempting to access a property on a null exifData object will fail the n8n execution.
Can I use a public image URL instead of uploading the binary?+
Yes. Set Input Data Type to URL and enter the full HTTPS address of the image in the Image URL field. PDF4me fetches the image directly from that URL and returns the metadata. The URL must be publicly accessible - authenticated or private storage URLs will not work unless you generate a signed/pre-signed URL first.
How do I use this node to validate images before storing them?+
Add Get Image Metadata immediately after the upload trigger. Map width, height, horizontalResolution, and fileSize into IF node conditions that check your publishing requirements - for example width >= 800 AND horizontalResolution >= 72 AND fileSize <= 5000000. Images that pass all conditions proceed to storage; those that fail are rejected with a notification to the uploader. This creates a fully automated image quality gate with zero manual review.

関連ノード​

ヘルプが必要な場合​