Create, edit, and transform images and videos programmatically in your n8n workflows
This is an n8n community node that lets you use JsonCut in your n8n workflows. JsonCut is a powerful media processing platform that enables you to create, edit, and transform images and videos programmatically through a comprehensive REST API.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Follow the installation guide in the n8n community nodes documentation.
- Go to Settings > Community Nodes
- Select Install
- Enter
n8n-nodes-jsoncutin Enter npm package name - Agree to the risks of using community nodes
- Select Install
After installing the node, you can use it like any other node in your workflows.
To use this node, you'll need a JsonCut API key. You can get one by:
- Signing up for a free account at app.jsoncut.com
- Navigate to your API settings
- Generate an API key
In n8n:
- Create new credentials of type "JsonCut API"
- Enter your API key
- Test the connection
The JsonCut node supports three main resources with various operations:
- Upload - Upload a file (image, video, audio, or font) to JsonCut
- Download - Download a file by its ID
- List - List your uploaded files with filtering options
- Get Metadata - Get metadata for a specific file
- Delete - Delete a file
- Validate - Validate a file without uploading it
- Create - Create a new image or video generation job
- Get Status - Get the current status of a job
- List - List your jobs with filtering options
- Cancel - Cancel a pending job
- Validate - Validate a job configuration without creating it
- Create and Wait - Create a job and automatically poll until completion, optionally downloading the output
- Full Pipeline - Upload input files, validate configuration, create job, wait for completion, and download output - all in one operation
This example creates an image generation job and waits for it to complete:
- Add the JsonCut node to your workflow
- Select Combined as the resource
- Select Create and Wait as the operation
- Set Job Type to "Image"
- Enter your job configuration in JSON format:
{
"width": 800,
"height": 600,
"format": "png",
"layers": [
{
"type": "rectangle",
"x": 0,
"y": 0,
"width": 800,
"height": 600,
"fill": "#3b82f6"
},
{
"type": "text",
"text": "Hello from n8n!",
"position": "center",
"fontSize": 48,
"color": "#ffffff"
}
]
}- Enable Download Output
- The node will create the job, wait for completion, and output the generated image
This example uploads an image, processes it, and downloads the result:
- Use a "Read Binary File" node to load an image
- Add the JsonCut node
- Select Combined as the resource
- Select Full Pipeline as the operation
- Configure the input files:
- Add a file item
- Set Binary Field to "data" (or your binary field name)
- Set Category to "image"
- Set TTL Hours to 24
- Configure your job:
{
"width": 1200,
"height": 630,
"format": "png",
"layers": [
{
"type": "image",
"path": "{{$json.uploadedFiles[0].storageUrl}}",
"position": "center",
"fit": "cover"
},
{
"type": "text",
"text": "Social Media Post",
"position": {
"x": 0.5,
"y": 0.1,
"originX": "center",
"originY": "top"
},
"fontSize": 72,
"color": "#ffffff"
}
]
}- Enable Download Output
- The node will handle the entire pipeline automatically
Create a video with text overlay:
{
"width": 1920,
"height": 1080,
"fps": 30,
"format": "mp4",
"clips": [
{
"duration": 5,
"layers": [
{
"type": "fill-color",
"color": "#1e293b"
},
{
"type": "title",
"text": "Welcome to JsonCut",
"position": "center",
"fontSize": 84,
"color": "#f1f5f9"
}
],
"transition": {
"name": "fade",
"duration": 1
}
},
{
"duration": 5,
"layers": [
{
"type": "fill-color",
"color": "#3b82f6"
},
{
"type": "subtitle",
"text": "Create videos programmatically",
"position": "center",
"fontSize": 48,
"color": "#ffffff"
}
]
}
]
}- Trigger: Schedule every day at 9 AM
- HTTP Request: Fetch content from your CMS
- JsonCut: Create image with dynamic text
- Twitter/LinkedIn: Post the generated image
- Read Binary Files: Load multiple images
- Split In Batches: Process 5 images at a time
- JsonCut (Full Pipeline): Process each image
- Save to Cloud Storage: Upload results to S3/Dropbox
- Webhook: Receive video request
- Set Variables: Extract parameters
- JsonCut: Generate video with custom text/images
- Send Email: Notify user when video is ready
- Polling Interval: How often to check job status (1-60 seconds, default: 5)
- Max Wait Time: Maximum time to wait for completion (1-120 minutes, default: 30)
- Category: Type of file (image, video, audio, font)
- TTL Hours: How long to keep the file (1-48 hours, default: 1)
- Job Type: Image or Video
- Configuration: JSON object with job parameters
- Validate Before Create: Validate configuration before submitting (recommended)
The node provides detailed error messages for common issues:
- Invalid API Key: Check your credentials
- Invalid Configuration: Validate your JSON configuration
- Insufficient Tokens: Check your account balance at app.jsoncut.com
- Job Failed: Check the error message in the output
- Timeout: Increase the Max Wait Time for long-running jobs
- JsonCut Homepage
- JsonCut Documentation
- API Reference
- Image Generation Guide
- Video Generation Guide
- n8n Documentation
- Community Forum
For issues with this n8n node:
- Open an issue on GitHub
For JsonCut API support:
- Email: support@jsoncut.com
- Documentation: docs.jsoncut.com
- Initial release
- File operations (upload, download, list, delete, validate)
- Job operations (create, status, list, cancel, validate)
- Combined operations (create & wait, full pipeline)
- Automatic polling for job completion
- Binary file support for uploads and downloads
Contributions are welcome! Please feel free to submit a Pull Request.
Made with ❤️ by the JsonCut team