Marketing Architects icon

Marketing Architects

Consume Marketing Architects API
Join our community

Actions7

Overview

The node integrates with the Marketing Architects API to create image collages from multiple image URLs. It allows users to specify a set of images, configure the canvas size and background color, and define the gap between images in the collage. This operation is useful for marketing professionals, designers, or content creators who want to programmatically generate visually appealing collages without manual image editing.

Practical examples include:

  • Creating promotional banners combining product images.
  • Generating social media posts with multiple photos arranged neatly.
  • Automating the creation of event photo collages.

Properties

Name Meaning
Images URLs of the images to include in the collage. Multiple image URLs can be added.
Canvas Width Width of the collage canvas in pixels (default 1920).
Canvas Height Height of the collage canvas in pixels (default 1080).
Background Color Background color of the canvas specified as a hex color code (default #ffffff).
Gap Gap between images in the collage in pixels (default 20).
Retry Settings Configuration for retrying the request on failure:
- Enable Retry Whether to retry the request if it fails (true/false).
- Max Retry Attempts Maximum number of retry attempts (1-10).
- Retry Delay Delay between retry attempts in seconds (1-60).
- Backoff Strategy Strategy for calculating retry delays: either fixed delay or exponential backoff.

Output

The node outputs JSON data representing the result of the collage creation request. The output typically includes metadata about the generated collage image such as its URL or identifier. The exact structure depends on the API response but generally contains:

  • A link or reference to the created collage image file (e.g., PNG).
  • Status or success indicators.
  • Any additional metadata returned by the API.

Binary data output is not explicitly handled by this node; instead, the collage image is referenced via URL or similar means.

Dependencies

  • Requires an API key credential for authenticating with the Marketing Architects API.
  • The node sends HTTP POST requests to the endpoint /image/collage on the Marketing Architects API base URL.
  • Proper network connectivity to the Marketing Architects API service is necessary.
  • No other external dependencies are required.

Troubleshooting

  • Common Issues:

    • Invalid or unreachable image URLs may cause the collage creation to fail.
    • Incorrect canvas dimensions or gap values might lead to unexpected layout results.
    • Network issues or invalid API credentials will prevent successful requests.

  • Error Messages:

    • Errors returned by the API are processed and surfaced by the node. Common errors include authentication failures, invalid input data, or server errors.
    • If retries are enabled, transient errors may be retried automatically according to the configured settings.

  • Resolution Tips:

    • Verify all image URLs are accessible and valid.
    • Ensure the API key credential is correctly configured and has necessary permissions.
    • Adjust retry settings if experiencing intermittent network failures.
    • Check that canvas size and gap values are reasonable and supported by the API.

Links and References

Discussion