Overview
This node integrates with the Flux Kontext Max service via the Wiro API to enhance product or object images, making them suitable for clean, e-commerce-ready visuals. It takes an input image URL and applies transformations based on a descriptive prompt, improving lighting, background, and overall presentation quality. This is particularly useful for online retailers or marketers who want to automate the enhancement of product photos for catalogs, websites, or advertisements.
Practical examples include:
- Enhancing a cookie package photo by adding clean lighting and a white background for better display.
- Improving the visual appeal of product images by adjusting aspect ratio and detail quality.
- Generating consistent image outputs using a fixed seed for reproducibility.
Properties
| Name | Meaning |
|---|---|
| Enter Your Image URL | The URL of the image you want to enhance with improved lighting and presentation. |
| Prompt | A textual description of how the image should be transformed (e.g., lighting, background). |
| Prompt Upsampling | Whether to improve the detail quality of the prompt interpretation (true/false). |
| Safety Tolerance | Level of safety filtering applied: "1" = strict, "2" = normal, "3" = loose. |
| Aspect Ratio | Desired output image aspect ratio. Options include: 1:1, 1:2, 16:9, 2:1, 2:3, 21:9, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 9:21, or match input image. |
| Seed | Fixed seed value to ensure reproducible results when generating enhanced images. |
| Output Format | Format of the output image file, such as "jpeg" or "png". |
Output
The node outputs a JSON object containing:
taskid: The unique identifier of the enhancement task.url: The URL of the enhanced image once processing is complete.status: The status of the task, which can be"completed"if successful or"failed"if an error occurred during processing.
No binary data is directly output by this node; instead, it provides a URL to the processed image hosted externally.
Dependencies
- Requires an API key credential for authenticating with the Wiro API service.
- Makes HTTP POST requests to the Wiro API endpoint at
https://api.wiro.ai/v1/Run/black-forest-labs/flux-kontext-max. - Uses a polling mechanism to wait until the image enhancement task completes, relying on a socket access token provided by the API.
- Requires network connectivity to access the external Wiro API service.
Troubleshooting
- Missing or invalid API credentials: Ensure that the API key and secret are correctly configured in the node credentials.
- API response missing task ID or socket token: This indicates an issue with the API request or service availability. Verify input parameters and network connectivity.
- Task status returns failure codes (-1, -2, -3, -4): These represent different failure states from the API. Check the prompt and input image URL for correctness and try again.
- Timeouts or long waits during polling: Network issues or slow processing on the API side may cause delays. Retry later or check service status.
- Invalid output format: Confirm that the output format is supported ("jpeg" or "png").
Links and References
- Wiro API Documentation (general reference for the API used)
- n8n Documentation for general node usage and credential setup