AdBlast icon

AdBlast

Interact with AdBlast API

Actions56

Overview

This node integrates with the AdBlast API to finalize the upload of a visual voiceover for a specific scene within a project. It is designed to confirm and complete the upload process by sending necessary identifiers and URLs related to the uploaded content.

Common scenarios where this node is beneficial include:

  • Finalizing the upload of voiceover audio or video assets linked to a visual scene in multimedia projects.
  • Automating the workflow of managing visual voiceovers in advertising, marketing, or media production pipelines.
  • Ensuring that uploaded assets are properly registered and accessible via CDN URLs for further processing or playback.

Practical example:

  • After uploading a voiceover file to an S3-compatible storage service, use this node to send the upload UUID, CDN URL, and relative path back to AdBlast to finalize the asset registration for a given project, scene, and visual element.

Properties

Name Meaning
Authentication Method Choose how to authenticate with the AdBlast API: either using saved credentials ("Predefined Credentials") or by entering an API key dynamically ("Dynamic API Key").
AdBlast Base URL The base URL of the AdBlast API endpoint. Required only if using dynamic API key authentication. Default is https://dev.adblast.ai.
API Key The API key used for authenticating requests when using dynamic API key authentication. Can be set using expressions.
Project Id The unique identifier of the project to which the visual voiceover belongs.
Scene Id The identifier of the scene within the project for which the voiceover upload is being finalized.
Visual Id The identifier of the visual element associated with the voiceover upload.
Uuid The upload UUID returned from the S3M finalize response, used to identify the specific upload session.
Cdn Url The CDN URL obtained from the S3M finalize response, pointing to the hosted location of the uploaded asset.
Path The relative path from the S3M finalize response indicating the location of the uploaded asset within the storage or CDN structure.

Output

The node outputs JSON data representing the response from the AdBlast API after finalizing the visual voiceover upload. This typically includes confirmation details about the upload status and any metadata returned by the API.

If the node supports binary data output (not explicitly shown in the provided code), it would represent the actual voiceover media or related files; however, based on the static analysis, the output is primarily JSON confirming the upload finalization.

Dependencies

  • Requires access to the AdBlast API, which necessitates an API key credential.
  • If using dynamic API key authentication, the user must provide the base URL and API key at runtime.
  • The node depends on the external AdBlast API service being available and reachable.
  • No additional environment variables or n8n-specific configurations beyond standard API credential setup are required.

Troubleshooting

  • Authentication errors: Ensure that the correct authentication method is selected and that the API key or saved credentials are valid and have sufficient permissions.
  • Invalid or missing IDs: Verify that the Project Id, Scene Id, Visual Id, and Uuid values correspond to existing entities in the AdBlast system.
  • Network issues: Confirm that the base URL is reachable and that there are no firewall or connectivity problems.
  • Malformed request body: Make sure that the Uuid, Cdn Url, and Path properties are correctly populated from the S3M finalize response; incorrect or missing values may cause the API to reject the request.

Common error messages might include unauthorized access, resource not found, or bad request due to missing parameters. Resolving these usually involves checking credentials, verifying input property values, and ensuring proper API endpoint configuration.

Links and References

Discussion