AdBlast icon

AdBlast

Interact with AdBlast API

Actions56

Overview

This node integrates with the AdBlast API to finalize the upload of a voiceover associated with a visual scene in a project. It is designed to confirm and complete the process of uploading a voiceover file that has been previously staged or uploaded (likely to an S3-compatible storage), by sending metadata such as UUID, CDN URL, and relative path back to the AdBlast service.

Common scenarios for this node include:

  • Finalizing voiceover uploads after recording or processing audio files for scenes in multimedia projects.
  • Automating the workflow of managing voiceovers linked to specific visuals and scenes within a project.
  • Integrating with cloud storage workflows where the actual audio files are uploaded separately, and this node confirms their availability and association.

Practical example:

  • A user records a voiceover for a scene in a video project, uploads the raw audio to cloud storage, then uses this node to finalize the upload by providing the UUID and URLs returned from the storage service, linking the voiceover to the correct visual and scene in the AdBlast system.

Properties

Name Meaning
Authentication Method Choose how to authenticate with the AdBlast API:
- Predefined Credentials: Use saved API credentials.
- Dynamic API Key: Enter API key dynamically using expressions.
AdBlast Base URL The base URL for the AdBlast API. Required only if using Dynamic API Key authentication. Default is https://dev.adblast.ai.
API Key The API key for authenticating requests to AdBlast. Required only if using Dynamic API Key authentication. Can be set dynamically via expressions.
Project Id The unique identifier of the project to which the voiceover belongs.
Scene Id The identifier of the scene within the project for which the voiceover is being finalized.
Visual Id The identifier of the visual element associated with the voiceover.
Uuid The upload UUID received from the S3M finalize response, representing the uploaded voiceover file.
Cdn Url The CDN URL from the S3M finalize response pointing to the hosted voiceover file.
Path The relative path from the S3M finalize response indicating the location of the voiceover file.

Output

The node outputs JSON data reflecting the response from the AdBlast API after finalizing the voiceover upload. This typically includes confirmation details about the finalized voiceover resource, such as status, identifiers, and possibly metadata confirming the linkage between the voiceover and the specified project, scene, and visual.

If the node supports binary data output (not explicitly shown in the provided code), it would represent the voiceover audio file or related media content. However, based on the static analysis, the node primarily handles JSON responses confirming the upload finalization.

Dependencies

  • Requires access to the AdBlast API endpoint, either via predefined credentials or dynamic API key.
  • Needs network connectivity to the specified AdBlast Base URL.
  • The user must have valid API credentials or keys with permissions to finalize voiceover uploads.
  • The node expects prior upload steps to have been completed, providing UUID, CDN URL, and path values from the S3M finalize response.

Troubleshooting

  • Authentication errors: If the API key or credentials are invalid or missing, the node will fail to authenticate. Ensure the correct API key is provided and matches the selected authentication method.
  • Invalid or missing parameters: The node requires all IDs (project, scene, visual) and upload metadata (UUID, CDN URL, path). Missing or incorrect values may cause API errors.
  • Network issues: Connectivity problems to the AdBlast API base URL can cause request failures. Verify network access and correct base URL configuration.
  • API response errors: If the AdBlast API returns errors (e.g., invalid UUID or resource not found), check that the upload was correctly performed and the UUID and URLs are accurate.

Links and References

Discussion