Overview

This node integrates with the Wiro AI API to create AI-powered product advertisements by combining product images with custom captions. It is useful for marketing and e-commerce scenarios where users want to generate promotional video ads or images with specific effects and aspect ratios. For example, a user can input a product photo URL, add a short promotional caption like 'SALE' or 'New Arrival', select video mode and aspect ratio, and apply an effect type to generate a customized product ad.

Use Case Examples

1. Creating a promotional video ad for a new product launch with a 'New Arrival' caption.
2. Generating a sale announcement video with a 'SALE' caption and a 16:9 aspect ratio.
3. Producing a product highlight video using the 'Pro' video mode and a specific visual effect.

Properties

Output

JSON

• taskid - The unique identifier of the task submitted to the Wiro API.
• url - The URL of the generated product ad video or image once the task is completed.
• status - The status of the task, which can be 'completed' or 'failed'.

Dependencies

• Wiro API key and secret credentials for authentication
• Uses a helper function to generate authentication headers
• Polls the Wiro API task status until completion using a polling utility

Troubleshooting

• If the API response does not include a valid task ID or socket access token, the node throws an error indicating an invalid response from the Wiro API.
• Task status codes '-1', '-2', '-3', or '-4' indicate failure states; users should verify input parameters and API credentials.
• Network or authentication issues may cause HTTP request failures; ensure API keys are correct and network connectivity is stable.

Links

• Wiro API Documentation - Official documentation for the Wiro AI API used by this node.