PiAPI Kling Effects icon

PiAPI Kling Effects

Generate videos with special effects using PiAPI Kling

Overview

This node integrates with the PiAPI Kling service to generate videos by applying special visual effects to images. It supports two main ways of providing the input image: either by specifying a direct URL or by using binary image data from previous nodes in the workflow. The node then applies one of the available effects (Squish or Expansion) to create a video output.

Common scenarios where this node is useful include:

  • Enhancing marketing materials by creating dynamic video content from static images.
  • Automating social media content generation with visually appealing effects.
  • Adding creative transformations to user-uploaded images in automated workflows.

For example, you could input a product image URL and apply the "Squish" effect to produce an engaging promotional video clip automatically.

Properties

Name Meaning
Image Source Choose where to get the image from: either from a URL or from binary data in a previous node.
Image URL The URL of the image to which the effect will be applied (required if Image Source is URL).
Binary Property The name of the binary property containing the image data (required if Image Source is Binary Data). Default is "data".
Effect The type of effect to apply to the image. Options are: "Squish" (compress/stretch effect) or "Expansion" (grow/expand effect).
Wait for Completion Whether the node should wait for the video generation task to complete before returning results (boolean).

Output

The node outputs JSON data containing details about the created task and its status. The key fields include:

  • task_id: Identifier of the created effect generation task.
  • Task metadata and status information returned by the PiAPI Kling service.
  • If "Wait for Completion" is enabled, the output includes the final completed task data once processing finishes.

No binary data is directly output by this node; instead, it provides metadata and references related to the generated video task.

Dependencies

  • Requires an API key credential for authenticating with the PiAPI Kling service.
  • Needs network access to call the PiAPI endpoints.
  • The node uses internal helper functions to handle binary data extraction and API requests.

Troubleshooting

  • Invalid image URL error: Occurs if the provided image URL is malformed or invalid. Ensure the URL is correct and accessible.
  • No binary data found: Happens when the specified binary property does not exist or contains no data. Verify that the previous node outputs binary data under the given property name.
  • API Error: Returned if the PiAPI service responds with an error code. Check your API credentials, network connectivity, and request parameters.
  • Timeout or long processing times: If "Wait for Completion" is enabled, the node waits for the task to finish, which may take time depending on the effect complexity and server load.

To resolve errors, verify input parameters, ensure valid credentials, and confirm that the image source is correctly specified.

Links and References

Discussion