Overview
This node generates videos from images using the PiAPI Skyreels service. It transforms a single input image into a video guided by a text prompt, allowing users to specify creative directions and constraints for the output. The node supports providing the source image either via a URL or as binary data from previous workflow steps.
Common scenarios include:
- Creating short video clips from static images for social media content.
- Generating dynamic visualizations based on descriptive prompts.
- Enhancing marketing materials with AI-generated video content derived from photos.
For example, a user might input a photo of a person and a prompt like "FPS-24, video of a young woman with long hair. She is wearing a light gray t-shirt." to produce a smooth 24 FPS video animation of that subject.
Properties
| Name | Meaning |
|---|---|
| Prompt | Text prompt guiding the video generation. Should include "FPS-24" for optimal frame rate. Example: FPS-24, video of a young woman with long hair... |
| Negative Prompt | Elements or features to avoid in the generated video, e.g., "chaotic, distortion, morphing". |
| Image Source | Select where to get the image from: • URL — load image from a web address • Binary Data — use image from a binary field in the workflow |
| Image URL | URL of the image to transform into a video (required if Image Source is URL). |
| Binary Property | Name of the binary property containing the image (required if Image Source is Binary Data). |
| Aspect Ratio | Aspect ratio of the generated video: • Landscape (16:9) — optimal for desktop viewing • Portrait (9:16) — optimal for mobile devices • Square (1:1) |
| Guidance Scale | Controls adherence to the prompt (range 0.1–10): Lower values = more creative output Higher values = more accurate to prompt |
| Wait for Completion | Whether to wait for the video generation task to complete before returning results (true/false). |
| Image Requirements Notice | Informational notice recommending clear images with good lighting and minimal background distractions for best results. Faces and human subjects work best. |
Output
The node outputs JSON data containing details about the video generation task:
- On success, the output JSON includes the full response from the API, which contains at least:
task_id: Identifier of the video generation task.- Other metadata related to the created video task.
If the "Wait for Completion" option is enabled, the node waits until the video generation finishes and returns the final task status and results.
The node does not output raw video binary data directly; instead, it provides metadata and task information that can be used to retrieve or process the generated video further.
Dependencies
- Requires an API key credential for the PiAPI Skyreels service.
- The node makes HTTP requests to the PiAPI endpoint
/api/v1/task. - Proper network access to download images from URLs if the image source is set to URL.
- n8n helper functions are used for HTTP requests and binary data handling.
Troubleshooting
- Invalid image URL: If the provided image URL is malformed or unreachable, the node throws an error indicating the URL is invalid or the image could not be downloaded.
- No binary data found: When using binary data as the image source, if the specified binary property does not exist or contains no data, an error is thrown.
- API Error: If the PiAPI service returns an error code, the node surfaces the message from the API response.
- Timeouts or delays: If "Wait for Completion" is enabled, long processing times may delay workflow execution. Consider disabling this option if immediate continuation is preferred.
- To handle errors gracefully, enable the node's "Continue On Fail" option to capture errors in the output JSON rather than stopping the workflow.
Links and References
- PiAPI Skyreels Documentation (example placeholder, replace with actual link if available)
- n8n Documentation on Custom Nodes
- Video Aspect Ratios Explained