Actions56
- Health Actions
- Project Actions
- Score Actions
- Characters Actions
- Environments Actions
- Scenes Actions
- Visuals Actions
- Visual Voiceover Actions
- Visual Image Actions
- Visual Video Actions
- Visual Sound Actions
- Video Actions
Overview
This node integrates with the AdBlast API to update the voiceover associated with a specific visual element within a scene of a project. It is particularly useful in scenarios where you need to programmatically modify or replace voiceover audio for visuals in multimedia projects, such as video editing, interactive presentations, or automated content generation workflows.
For example, if you have a project with multiple scenes and visuals, and you want to update the narration or voiceover text/audio for a particular visual dynamically based on user input or other data sources, this node allows you to do so by specifying the project, scene, and visual identifiers along with the new voiceover content or URL.
Properties
| Name | Meaning |
|---|---|
| Authentication Method | Choose how to authenticate: either use saved API credentials or provide an API key dynamically. |
| AdBlast Base URL | The base URL of the AdBlast API (required if using dynamic API key authentication). |
| API Key | The API key for authenticating requests when using dynamic authentication method. |
| Project Id | The unique identifier of the project containing the scene and visual to update. |
| Scene Id | The unique identifier of the scene within the project where the visual resides. |
| Visual Id | The unique identifier of the visual element whose voiceover will be updated. |
| Text | The new voiceover text to associate with the visual. |
| Voiceover Url | A remote URL pointing to a voiceover audio file to download and store for the visual. |
| Voiceover Uploaded Url | A remote URL pointing to an uploaded voiceover audio file to download and store for the visual. |
Output
The node outputs JSON data representing the response from the AdBlast API after updating the voiceover for the specified visual. This typically includes confirmation details about the update operation, such as status, updated resource information, or error messages if any.
If the node handles binary data (e.g., downloading voiceover audio), it would manage storing or referencing that data accordingly, but based on the provided code and properties, the output focuses on JSON responses related to the update operation.
Dependencies
- Requires access to the AdBlast API.
- Needs either predefined saved API credentials or a dynamically provided API key.
- If using dynamic authentication, the base URL for the AdBlast API must be specified.
- Proper network connectivity to reach the AdBlast service endpoint.
Troubleshooting
- Authentication Errors: Ensure that the API key or saved credentials are valid and have sufficient permissions to update voiceovers.
- Invalid Identifiers: Verify that the
Project Id,Scene Id, andVisual Idcorrespond to existing resources in your AdBlast account. - Network Issues: Confirm that the base URL is correct and accessible from your environment.
- Malformed Input: Make sure the voiceover text or URLs are correctly formatted and reachable.
- API Limits: Be aware of any rate limits or quotas imposed by the AdBlast API that might affect request success.
Links and References
- AdBlast API Documentation (Base URL and API reference)
- n8n Documentation on Creating Custom Nodes