AdBlast icon

AdBlast

Interact with AdBlast API

Actions56

Overview

This node integrates with the AdBlast API to update a visual image in a scene by generating or modifying an image based on a text prompt. Specifically, it supports the "Update Text To Image For A Scene Visual" operation under the "Visual Image" resource. This operation is useful for scenarios where you want to dynamically create or update images in a project’s scene using AI-driven text-to-image rendering.

Practical examples include:

  • Automatically generating scene visuals from descriptive prompts in a storytelling or game development workflow.
  • Updating character or environment images in a project based on new textual descriptions.
  • Enhancing creative workflows by programmatically controlling visual content updates without manual image editing.

Properties

Name Meaning
Authentication Method Choose between using saved API credentials ("Predefined Credentials") or entering an API key dynamically ("Dynamic API Key").
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 to AdBlast (used if dynamic API key authentication is selected).
Project Id The unique identifier of the project where the visual image belongs.
Scene Id The identifier of the scene within the project to update the visual image.
Visual Id The identifier of the specific visual image to update within the scene.
Prompt The full text instruction describing what the image should depict; used for text-to-image rendering.
Visible Characters JSON array listing character IDs that should be visible in the updated image.
Visible Environments JSON array listing environment IDs that should be visible in the updated image.
Image Url A remote image URL to download and store as part of the visual update (alternative or supplement to prompt).

Output

The node outputs JSON data representing the response from the AdBlast API after updating the visual image. This typically includes details about the updated image resource such as its ID, status, URLs, metadata, or any other relevant information returned by the API.

If the API supports returning binary image data directly, the node would handle this accordingly, but based on the provided code and properties, the output is primarily JSON structured data describing the updated visual.

Dependencies

  • Requires access to the AdBlast API endpoint, either via predefined credentials or dynamic API key input.
  • Needs proper API authentication token (API key) to authorize requests.
  • Network connectivity to the specified AdBlast Base URL.
  • No additional external libraries beyond those bundled with n8n and the included OpenAPI client are required.

Troubleshooting

  • Authentication errors: Ensure the API key is valid and correctly provided according to the chosen authentication method. If using dynamic API key, verify expressions resolve properly.
  • Invalid project, scene, or visual IDs: Confirm that the IDs correspond to existing resources in your AdBlast account.
  • Malformed JSON in Visible Characters or Visible Environments: These fields expect valid JSON arrays; invalid JSON will cause request failures.
  • Network issues or incorrect Base URL: Verify the AdBlast Base URL is reachable and correct.
  • Prompt-related errors: Ensure the prompt string is meaningful and complies with any length or content restrictions imposed by the API.

Common error messages will generally relate to HTTP status codes like 401 Unauthorized, 404 Not Found (invalid IDs), or 400 Bad Request (invalid parameters). Checking the exact API response message can guide resolution.

Links and References

Discussion