Overview
This node integrates with Tencent Video on Demand (VOD) service to manage video content through various operations such as uploading videos from a URL, confirming upload task status, composing media from multiple sources, and submitting media processing tasks.
A common use case is automating video uploads to Tencent VOD directly from URLs, which is useful for content creators or platforms that need to programmatically ingest video files without manual intervention. For example, you can provide a direct link to a video file hosted elsewhere, specify the desired name in the VOD system, and have the node handle the upload process.
Other scenarios include checking the status of ongoing upload or processing tasks, combining multiple video segments into one, or submitting complex media processing jobs like transcoding or thumbnail generation.
Properties
| Name | Meaning |
|---|---|
| Media URL | The URL address of the video file to be uploaded. |
| Video Name | The name under which the video will be stored in Tencent VOD. |
These properties are required when using the Upload Video operation.
Output
The node outputs an array of JSON objects, each representing the result of processing an input item. For the Upload Video operation, each output object contains:
success: Boolean indicating if the upload request was successfully initiated.taskId: The unique identifier of the upload task assigned by Tencent VOD.videoName: The name given to the video in the VOD system.
For other operations (not requested here), the output includes relevant task details such as status and response data.
The node does not output binary data; all outputs are JSON-formatted metadata about the video upload or task status.
Dependencies
- Requires an API key credential for Tencent VOD service authentication.
- Uses Tencent Cloud's VOD API endpoints (
vod.tencentcloudapi.com) with HTTPS requests. - Node expects valid credentials with permissions to perform video upload and management operations.
- No additional environment variables are explicitly required beyond the API credentials.
Troubleshooting
- Missing or invalid credentials: The node requires valid Tencent VOD API credentials. Ensure the API key and secret are correctly configured in n8n.
- Invalid Media URL: If the provided video URL is inaccessible or invalid, the upload will fail. Verify the URL is publicly accessible and points directly to a video file.
- Upload task creation failure: Errors like "Failed to get upload info" indicate issues with the API request or parameters. Check the video name and URL inputs.
- API errors: The node surfaces Tencent VOD API error messages. Common causes include quota limits, permission issues, or malformed requests.
- JSON parsing errors: For other operations involving JSON input, 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.