Overview
This node integrates with the Flux Kontext Pro service via the Wiro API to apply artistic or conceptual transformations to images. Users provide an input image URL and a descriptive prompt explaining how they want the image transformed (e.g., "Make this a 90s cartoon"). The node sends these inputs to the API, which processes the image accordingly and returns a transformed image URL once the task completes.
Common scenarios include:
- Enhancing images with creative styles for marketing or social media.
- Generating concept art or stylized visuals from existing photos.
- Automating image modifications based on textual prompts without manual editing.
For example, a user might input a photo of a landscape and use the prompt "Turn into a watercolor painting" to get a stylized version of that image.
Properties
| Name | Meaning |
|---|---|
| Enter Your Image URL | URL of the image to be transformed. |
| Prompt | Text description of how the image should be transformed (e.g., style, theme). |
| Prompt Upsampling | Boolean option to improve the detail quality of the prompt interpretation. |
| Safety Tolerance | Level of safety filtering applied to the transformation: 1 = strict, 2 = normal, 3 = loose. |
| Aspect Ratio | Desired aspect ratio of the output image. Options include common ratios like 1:1, 16:9, etc., or match input image. |
| Seed | Fixed seed value for reproducibility of results. |
| Output Format | Format of the output image file, e.g., jpeg or png. |
Output
The node outputs a JSON object containing:
taskid: The unique identifier of the transformation task.url: The URL of the transformed image once processing is complete.status: Status of the task, either"completed"if successful or"failed"if not.
No binary data is directly output by the node; instead, users receive a URL to access the processed image.
Example output JSON:
{
"taskid": "123456789",
"url": "https://api.wiro.ai/output/processed-image.jpeg",
"status": "completed"
}
Dependencies
- Requires an API key credential for the Wiro API service.
- Needs network access to
https://api.wiro.aiendpoints. - Uses helper functions to generate authentication headers and poll the task status until completion.
- No additional environment variables are explicitly required beyond the API credentials.
Troubleshooting
- Missing or invalid API credentials: Ensure the API key and secret are correctly configured in n8n credentials.
- API response missing task ID or socket token: This indicates a problem with the request or service availability. Verify all required parameters are provided and valid.
- Task status returns failed: Could be due to unsupported prompt content, image URL issues, or internal API errors. Try adjusting prompt, safety tolerance, or verifying the input image URL accessibility.
- Timeout waiting for task completion: Network issues or slow processing may cause delays. Check connectivity and consider increasing any polling timeout settings if available.
Links and References
- Wiro API Documentation (hypothetical link for reference)
- Flux Kontext Pro Service (official site for the transformation engine)
This summary is based solely on static analysis of the provided source code and property definitions.