CloudConvert icon

CloudConvert

Use CloudConvert to convert files, create thumbnails, merge files, add watermarks and more!

Overview

This node uses the CloudConvert service to create thumbnails from files. It allows users to specify the input file either as binary data or as text content, define the desired thumbnail dimensions (width and height), and choose the resizing mode (fit) such as max, crop, or scale. This operation is useful for generating smaller preview images of larger files, which can be used in galleries, previews, or as icons.

Use Case Examples

  1. Creating a thumbnail image from an uploaded photo to display as a preview in a web application.
  2. Generating thumbnails for a batch of images to be used in a content management system.

Properties

Name Meaning
Authentication Method of authenticating with CloudConvert API, either OAuth2 or API Key.
Output Format The output format for the thumbnail image, e.g., jpg, png.
Binary Input Data Whether the input file is provided as binary data in a binary property.
Input File Contents The text content of the file to upload if not using binary data.
Input File Name The filename including extension when input is provided as text content.
Binary Property The name of the binary property containing the input file data when using binary input.
Width The width in pixels of the thumbnail to create.
Height The height in pixels of the thumbnail to create.
Fit The resizing mode for the thumbnail: max (fit within dimensions without enlarging), crop (fill dimensions and crop excess), or scale (force exact dimensions).
Additional Options A JSON dictionary of extra options to customize the thumbnail creation task.

Output

JSON

  • id - The unique identifier of the created thumbnail job or task.
  • status - The status of the thumbnail creation process (e.g., pending, completed).
  • result
    • url - The URL to access or download the created thumbnail image.

Dependencies

  • CloudConvert API service

Troubleshooting

  • Ensure the input file is correctly provided either as binary data or text content with a valid filename.
  • Verify that the output format is supported and correctly specified.
  • Check authentication credentials (OAuth2 or API Key) are valid and have necessary permissions.
  • Common errors include invalid operation errors if the operation parameter is incorrect, or file upload errors if the input data is missing or malformed.

Links

Discussion