Overview
This node generates high-quality 4K mobile phone wallpapers using an AI service called Wiro. It takes a textual description (prompt) of the desired wallpaper and produces images based on that input. The node is useful for creative professionals, designers, or hobbyists who want to quickly generate unique mobile wallpapers without manual graphic design work.
Typical use cases include:
- Creating custom wallpapers for mobile devices based on specific themes or styles.
- Generating multiple variations of wallpapers by adjusting parameters like seed or number of samples.
- Experimenting with different artistic prompts and negative prompts to refine output quality.
For example, you could input a prompt like "minimal futuristic cityscape at sunset" and receive a set of generated wallpapers matching that description.
Properties
| Name | Meaning |
|---|---|
| Prompt | Description of what you want to create in the wallpaper. |
| Negative Prompt | List of undesired elements to exclude from the wallpaper (e.g., low quality, blurry, watermark). |
| Steps | Number of inference steps the AI should take to generate the image (affects detail and quality). |
| Scale | Guidance scale controlling how closely the generation follows the prompt (higher means stricter). |
| Seed | Random seed value to produce different generations; same seed yields reproducible results. |
| Width | Width of the output image in pixels. |
| Height | Height of the output image in pixels. |
| Samples | Number of wallpaper samples to generate per execution. |
Output
The node outputs a JSON object containing:
taskid: The unique identifier of the generation task.url: The URL to the generated wallpaper image (present if generation completed successfully).status: Status of the generation task, which can be:"completed": Image generation finished successfully."failed": Generation failed due to some error.
The output does not directly contain binary image data but provides a URL to access the generated wallpaper(s).
Dependencies
- Requires an API key credential for the Wiro AI service.
- Makes HTTP POST requests to the Wiro API endpoint
https://api.wiro.ai/v1/Run/wiro/text-to-image-sana. - Uses a helper function to generate authentication headers for the API request.
- Polls the Wiro service via a socket token until the image generation task completes.
Troubleshooting
- Missing or invalid API credentials: Ensure the API key and secret are correctly configured in the node credentials.
- API response missing task ID or socket token: This indicates a problem with the API call or service availability. Check network connectivity and API limits.
- Task status returns "failed": The generation process encountered an error. Try adjusting input parameters such as prompt complexity, steps, or scale.
- Timeout during polling: If the node waits too long for completion, verify the Wiro service status or increase timeout settings if available.
Links and References
- Wiro AI official website (for more information about the AI service)
- n8n documentation on creating custom nodes