Overview
The "Media Upload" operation of this node allows users to upload image or video media files to the Blotato platform. It supports two main methods for uploading:
- Using a public URL: Provide a publicly accessible URL pointing to the media file.
- Using binary data: Upload media directly from binary data available in the workflow (e.g., from a previous node). This method has a size limit of 15MB.
This node is useful when you want to programmatically add media assets to your Blotato account, which can then be used in video creation, posts, or other automation workflows within Blotato.
Practical examples:
- Uploading an image from a public URL to use as part of a social media post.
- Uploading a small video clip directly from binary data obtained earlier in the workflow.
- Automating media uploads as part of a content pipeline that integrates with Blotato's video and post creation features.
Properties
| Name | Meaning |
|---|---|
| Use Binary Data | Whether to upload media using binary data from the workflow instead of a URL. Note: Binary uploads are limited to 15MB. For larger files, use URL upload with external services like Google Drive, Dropbox, Frame.io, or S3/GCS buckets. |
| Media URL | The publicly accessible URL of the image or video to upload. Only shown if "Use Binary Data" is false. |
| Input Binary Field | The name of the binary property containing the media to upload. Only shown if "Use Binary Data" is true. Defaults to "data". |
Output
The node outputs JSON data representing the response from the Blotato API after uploading the media. The structure typically includes details about the uploaded media item such as its ID, URL, status, or any metadata returned by the API.
If the upload is successful, the output JSON contains the media information as returned by the Blotato service.
If an error occurs during upload, the output will contain an error object with details about the failure.
The node does not output binary data itself; it only sends binary data as input if selected.
Dependencies
- Requires an active Blotato API credential configured in n8n with appropriate permissions to upload media.
- The node makes authenticated HTTP requests to the Blotato API server endpoint.
- For URL uploads, the media URL must be publicly accessible.
- For binary uploads, the binary data size must not exceed 15MB due to API limitations.
- For larger files, users should upload media via external storage services (Google Drive, Dropbox, Frame.io, S3/GCS) and provide the public URL instead.
Troubleshooting
File size exceeds 15MB limit for binary upload:
Error message:File size (XX.XXMB) exceeds 15MB limit. Large files should be uploaded via URL instead of binary data.
Solution: Use the "Media URL" option with a publicly accessible link to the media stored on an external service.Invalid or inaccessible media URL:
If the provided URL is not publicly accessible or invalid, the upload will fail.
Solution: Ensure the URL is correct and accessible without authentication.Missing binary data field:
If "Use Binary Data" is enabled but the specified binary property does not exist or is empty, the node will throw an error.
Solution: Verify the binary property name matches the actual binary data field from previous nodes.API authentication errors:
Errors related to credentials or authorization may occur if the API key is missing, invalid, or lacks permissions.
Solution: Check and update the Blotato API credential in n8n.Network or server errors:
Temporary network issues or server-side problems may cause request failures.
Solution: Retry later or check Blotato system status.
Links and References
- Blotato Media Requirements — Details on supported media formats and sizes.
- Blotato API Dashboard — Useful for debugging API requests and monitoring usage.
- Blotato Video Templates — Explore video templates that can use uploaded media.
- External storage recommendations for large files: Google Drive, Dropbox, Frame.io, Amazon S3, Google Cloud Storage.