VLM Run icon

VLM Run

Interact with VLM Run API

Actions6

Overview

This node integrates with the VLM Run API to manage files and perform various media analysis operations. Specifically, for the Manage Files resource with the Manage Files operation, it allows users to either list all files currently uploaded to the VLM Run service or upload new files from previous workflow nodes.

Common scenarios where this node is beneficial include:

  • Automating file management workflows by retrieving a list of files stored in VLM Run.
  • Uploading files dynamically from other parts of an n8n workflow to VLM Run for further processing or storage.
  • Integrating file uploads into larger automation pipelines involving media analysis or agent execution.

Practical example:

  • A user wants to upload a document or media file processed earlier in the workflow to VLM Run for archival or subsequent analysis.
  • A user needs to retrieve and display all files currently stored in their VLM Run account to decide which to process next.

Properties

Name Meaning
File Operation Choose between "List Files" (retrieve all files) or "Upload File" (upload a new file).
File The file data to upload, typically coming from a previous node's output. Required when uploading a file.

Output

The node outputs JSON data structured as follows depending on the selected file operation:

  • List Files:
    Outputs an object with a files property containing an array of file metadata objects retrieved from VLM Run.

  • Upload File:
    Outputs an object representing the uploaded file details returned by the VLM Run API after successful upload.

If the node supports binary data input for uploads, it processes that internally but does not output binary data itself.

Dependencies

  • Requires an API key credential for authenticating with the VLM Run API.
  • Relies on internal helper functions to process files and interact with the VLM Run API endpoints.
  • No additional environment variables are explicitly required beyond the API authentication setup.

Troubleshooting

  • Error: "Failed to obtain uploaded file URL"
    This indicates the upload succeeded but the node could not retrieve the public URL for the uploaded file. Check API permissions and ensure the upload endpoint returns the expected response.

  • Error: "At least one file mapping is required when multiple files is enabled"
    Occurs if multiple file upload mode is enabled without providing proper file mappings. Provide valid key-URL pairs for each file.

  • General API errors
    Network issues, invalid credentials, or malformed requests can cause failures. Verify API keys, network connectivity, and input data correctness.

  • Unsupported operation error
    If an unsupported operation value is set, the node will throw an error. Ensure only supported operations ("list" or "upload") are selected under the Manage Files resource.

Links and References

Discussion