ClipMagic icon

ClipMagic

Interact with ClipMagic API for video and audio processing

Actions7

Overview

This node integrates with the ClipMagic API to perform various video and audio processing tasks. The "Convert Media" operation specifically allows users to convert media files from one format to another, supporting both audio and video formats. It can also scale video resolution and adjust bitrate for video outputs.

Common scenarios where this node is beneficial include:

  • Converting audio files (e.g., WAV to MP3) for compatibility or size reduction.
  • Changing video container formats (e.g., MOV to MP4).
  • Resizing videos to specific resolutions for different devices or platforms.
  • Adjusting video bitrate to balance quality and file size.

Practical example: A user has a video in MOV format and wants to convert it to MP4 at 720p resolution with a target bitrate of 1500 kbps for uploading to a streaming platform that requires MP4 videos.

Properties

Name Meaning
Media URL Direct URL to the input media file or a Google Drive share link.
Output Format Target output format. Options: MP3, WAV, AAC, MP4, MOV.
Resolution Video height scaling option (ignored for audio). Options: Original, 360p, 480p, 720p, 1080p.
Bitrate (kbps) Target video bitrate in kilobits per second (max 3000). Use 0 for automatic bitrate selection.

Output

The node outputs JSON data indicating success status, operation type, filename, and content type of the processed media. If the response contains binary media data (audio/video), it is included as binary data under the binary.data field.

Output structure example for successful conversion with binary data:

{
  "json": {
    "success": true,
    "operation": "convert",
    "filename": "output.mp3",
    "contentType": "audio/mpeg"
  },
  "binary": {
    "data": "<binary media data>"
  }
}

If the response is not binary media, the JSON will contain the parsed API response fields along with success status.

Dependencies

  • Requires an API key credential for authenticating with the ClipMagic API.
  • The node makes HTTP requests to the ClipMagic service base URL configured in credentials.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Invalid Media URL: Ensure the provided media URL is accessible and direct (not behind authentication or expired links).
  • Unsupported Format: Verify that the input media format is supported by ClipMagic and that the requested output format is valid.
  • Bitrate Limits: Bitrate must be between 0 and 3000 kbps; values outside this range may cause errors.
  • API Authentication Errors: Confirm that the API key credential is correctly configured and active.
  • Network Issues: Check internet connectivity and firewall settings that might block access to the ClipMagic API endpoint.

Common error messages:

  • "Unknown operation": Occurs if an unsupported operation value is set; ensure "convert" is selected for this operation.
  • API errors returned from ClipMagic will be passed through; review the error message for details.

Links and References

Discussion