Overview
This node removes the background from any image using an AI-powered service. It is useful for automating image editing workflows where you need to isolate subjects by removing backgrounds, such as preparing product photos for e-commerce, creating marketing materials, or generating transparent images for graphic design.
The node accepts an image URL and sends it to an external API that processes the image asynchronously. It then polls the task status until completion and outputs the result, including a URL to the processed image with the background removed.
Properties
| Name | Meaning |
|---|---|
| Image URL | URL of the image to remove background from. |
Output
The node outputs a JSON object with the following structure:
taskid: The unique identifier of the background removal task.url: The URL of the processed image with the background removed (empty if the task failed).status: The status of the task, either"completed"if successful or"failed"otherwise.
Example output JSON:
{
"taskid": "string",
"url": "string",
"status": "completed" | "failed"
}
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authentication with the external AI background removal service.
- Uses an asynchronous polling mechanism to wait for the image processing task to complete.
- Requires network access to the external API endpoint at
https://api.wiro.ai/v1/Run/wiro/remove-background.
Troubleshooting
- Missing or invalid credentials: Ensure that the API key and secret are correctly configured in the node's credentials.
- Invalid or inaccessible image URL: Verify that the provided image URL is publicly accessible and points to a valid image.
- API response missing task ID or token: This indicates an issue with the API request or service availability; check the API key validity and service status.
- Task failure statuses (
-1,-2,-3,-4): These indicate different failure modes from the API. Retrying with a different image or checking API limits may help. - Timeouts during polling: Network issues or slow processing might cause timeouts; ensure stable internet connectivity.
Links and References
- Wiro AI Background Removal API Documentation (hypothetical link based on the API domain)