Overview
This node integrates with Tencent Video on Demand (VOD) service to manage video uploads and processing tasks. It supports operations such as uploading a video from a URL, confirming the status of upload or processing tasks, composing multiple media files into one video, and submitting various media processing tasks.
Common scenarios where this node is beneficial include:
- Automatically uploading videos hosted elsewhere by providing their URLs.
- Tracking the progress or result of video upload or processing tasks.
- Combining multiple video or audio tracks into a single media file.
- Submitting AI recognition or other media processing jobs supported by Tencent VOD.
For example, you can use this node to pull a video from a public URL and upload it to your Tencent VOD account, then periodically check the upload task status until completion.
Properties
| Name | Meaning |
|---|---|
| Media URL | The URL address of the video file to be uploaded. |
| Video Name | The name to assign to the video within Tencent VOD after upload. |
These properties are required when performing the "Upload Video" operation.
Output
The node outputs an array of JSON objects, each representing the result of the requested operation for each input item. For the "Upload Video" operation, the output JSON includes:
success: Boolean indicating if the operation succeeded.taskId: The unique identifier of the upload task assigned by Tencent VOD.videoName: The name given to the video in Tencent VOD.
For other operations (not requested here), the output may include additional fields like Response, status, or detailed response data from Tencent VOD API.
The node does not output binary data; all outputs are JSON-formatted metadata about the video tasks.
Dependencies
- Requires an API key credential for Tencent VOD with appropriate permissions.
- Uses Tencent VOD's official API endpoints (
vod.tencentcloudapi.com) over HTTPS. - Node expects credentials containing a secret ID and secret key for authentication.
- No additional environment variables are needed beyond the configured credentials.
Troubleshooting
- Missing or invalid credentials: Ensure that the Tencent VOD API key and secret are correctly configured in n8n credentials.
- Invalid Media URL: The provided video URL must be accessible and valid; otherwise, the upload will fail.
- Task ID errors: When confirming tasks, ensure the correct Task ID is used.
- API errors: The node surfaces error messages returned by Tencent VOD API, which often indicate issues like permission problems, invalid parameters, or network errors.
- JSON parsing errors: For operations requiring JSON input (like compose or submitTask), ensure the JSON is well-formed.
If an error occurs, the node throws an error prefixed with "Tencent VOD error:" followed by the specific message from the API or internal validation.