AdBlast icon

AdBlast

Interact with AdBlast API

Actions56

Overview

This node integrates with the AdBlast API to create a new character within a specified project. It allows users to define a unique character by providing an ID, a descriptive prompt, and optionally indicate if the character's image is currently being processed. This node is useful in scenarios where automated character creation is needed, such as game development, storytelling applications, or any system that requires dynamic character generation based on textual descriptions.

Practical examples:

  • Automatically generating characters for a role-playing game by providing unique IDs and descriptive prompts.
  • Creating avatars or NPCs in interactive stories or simulations.
  • Managing character assets in creative projects where character metadata needs to be programmatically created and updated.

Properties

Name Meaning
Authentication Method Choose between using saved API credentials or entering an API key dynamically via expressions.
AdBlast Base URL The base URL of the AdBlast API (required only if using dynamic API key authentication).
API Key The API key for authenticating requests (required only if using dynamic API key authentication).
Project Id The identifier of the project under which the character will be created.
Id A unique valid UUID representing the character's ID.
Prompt A text description that defines the character's attributes or appearance.
Processing Boolean flag indicating whether the character's image is currently being generated (default false).

Output

The node outputs JSON data representing the newly created character object as returned by the AdBlast API. This typically includes the character's ID, prompt, processing status, and potentially other metadata related to the character creation response.

If the API supports binary data (e.g., images), this node does not explicitly handle binary output in the provided code, so the output is expected to be purely JSON.

Dependencies

  • Requires access to the AdBlast API endpoint.
  • Needs either predefined API credentials stored securely in n8n or a dynamically provided API key.
  • Proper configuration of the base URL when using dynamic API keys.
  • Network connectivity to the specified AdBlast API base URL.

Troubleshooting

  • Authentication errors: Ensure that the API key is valid and correctly configured. If using predefined credentials, verify they are up to date.
  • Invalid UUID: The character ID must be a valid UUID; otherwise, the API may reject the request.
  • Missing required fields: The project_id, id, and prompt fields are mandatory. Omitting them will cause errors.
  • API endpoint issues: Confirm the base URL is correct and reachable, especially when using dynamic URLs.
  • Processing flag misuse: Setting the processing flag incorrectly might lead to inconsistent state representation.

Links and References

Discussion