Actions15
Overview
This node integrates with the Placid API to generate images based on predefined templates. It allows users to create customized images by selecting a template and modifying its layers either through a simple form interface or by providing advanced JSON configurations. This is particularly useful for automating the creation of dynamic visuals such as social media posts, marketing banners, personalized graphics, or any scenario where templated image generation is needed.
For example, a marketing team could use this node to automatically generate promotional images with updated text and logos for different campaigns without manual graphic design work.
Properties
| Name | Meaning |
|---|---|
| Template | Select the Placid template to use for image generation. Can be chosen from a searchable list or entered directly by UUID. |
| Configuration Mode | Choose how to configure the template layers: - Simple: Use form fields to modify individual layers. - Advanced: Define all layer modifications using a JSON object. |
| Layers (Simple) | Add one or more layers to modify, each with: - Layer Name (e.g., "title", "logo") - Layer Type (Text, Picture, Shape, Browserframe, Barcode, Rating, Subtitle) - Property to set depending on layer type - Value for the property (text content, color, URL, visibility, etc.) |
| Layers (JSON) | Define all layer modifications as a JSON object in advanced mode. Example: {"title": {"text": "Hello World"}, "image": {"image": "https://example.com/photo.jpg"}} |
| Additional Options | Optional fields: - Webhook Success URL: URL to receive the generated image when ready. - Passthrough Data: Custom data included in webhook responses and requests (max 1024 characters). |
Layer Properties (Simple Mode)
- Text Layer Properties: Text Content, Text Color, Font, Alternate Text Color, Alternate Font, Visibility, Custom Property.
- Picture Layer Properties: Image URL, Image File (binary upload), Visibility, Custom Property.
- Shape Layer Properties: Background Color, Border Color, Border Radius, Border Width, SVG URL, Visibility, Custom Property.
- Browserframe Layer Properties: Image URL or website URL, Viewport size, URL for address bar, Visibility, Custom Property.
- Barcode Layer Properties: Barcode value, Color, Visibility, Custom Property.
- Rating Layer Properties: Rating value (0-5 or 0-10 scale), Visibility, Custom Property.
- Subtitle Layer Properties: Visibility, Custom Property.
Output
The node outputs JSON data representing the result of the image generation request. This typically includes metadata about the created image and URLs to access the generated image file. If a webhook URL is provided, the actual image file will be sent asynchronously to that URL once generation completes.
Binary data upload is supported for picture layers, allowing direct inclusion of image files from previous nodes.
Dependencies
- Requires an API key credential for authenticating with the Placid API.
- The node depends on Placid's external API services for template retrieval and image generation.
- For webhook functionality, a publicly accessible URL must be provided to receive callbacks.
Troubleshooting
- Invalid Template ID: Ensure the selected template exists and the ID is correct. Use the searchable list mode to avoid typos.
- Layer Configuration Errors: When using advanced JSON mode, verify the JSON structure matches expected format; invalid JSON or incorrect layer names/properties will cause errors.
- Binary Data Issues: When uploading images via binary data, confirm the field name matches the input binary property and that the binary data is valid.
- Webhook Failures: If webhook URL is unreachable or misconfigured, image delivery will fail. Verify the URL is correct and publicly accessible.
- API Authentication Errors: Check that the API key credential is correctly configured and has necessary permissions.