Overview
This node generates a video animation from one or two input images using the KlingAI 1.6 model via the Wiro API. It is designed to create smooth animated videos by specifying a starting image (mandatory) and optionally an ending image, along with descriptive prompts that guide the animation style and content.
Common scenarios where this node is beneficial include:
- Creating short animated clips from static images for social media or marketing.
- Generating artistic or surreal video effects based on textual descriptions.
- Enhancing visual storytelling by animating portraits or scenes with motion cues.
For example, you can input a portrait photo URL as the first frame and describe an underwater flowing hair effect in the prompt to generate a dynamic video clip of that scene.
Properties
| Name | Meaning |
|---|---|
| Input Image (First Frame) URL | Public URL of the image used as the first frame of the animation (required). |
| Input Image (Last Frame) URL | Optional public URL of the image used as the last frame of the animation; only for Video Mode Pro. |
| Prompt | Text description of the desired overall animation or motion effect (required). |
| Negative Prompt | Text describing unwanted elements in the video, e.g., "blurry, distorted, bad anatomy". |
| Video Duration (Seconds) | Length of the generated video in seconds (required). |
| Video Mode | Mode of video generation; options include standard ("std") and possibly others like "pro". |
| Scale | Classifier-free guidance scale controlling adherence to the prompt; typically a decimal value. |
Output
The node outputs JSON data containing:
taskid: The unique identifier for the video generation task.url: The URL of the completed video once processing finishes (empty if not completed).status: Status of the task, which can be"completed"or"failed".
No binary data output is produced directly by this node; instead, it provides a URL to access the generated video.
Dependencies
- Requires an API key credential for authenticating with the Wiro API service.
- Uses the external Wiro API endpoint at
https://api.wiro.ai/v1/Run/klingai/image-to-video-klingai-v1++6. - Relies on helper functions for authentication header generation and polling task completion.
- Network connectivity to the Wiro API is necessary.
Troubleshooting
- Missing or invalid API credentials: The node requires valid API keys; ensure these are configured correctly.
- Invalid or inaccessible image URLs: The input image URLs must be publicly accessible; private or broken links will cause failures.
- API response missing task ID or token: If the API does not return expected identifiers, the node throws an error indicating invalid response.
- Task failure statuses: The node interprets certain returned status codes (
-1,-2,-3,-4) as failure states; check prompt accuracy, image validity, and API limits. - Timeouts or long waits: Video generation may take time; ensure the polling mechanism completes successfully or adjust timeout settings if applicable.