Postiz icon

Postiz

Consume Postiz API

Overview

This node integrates with the Postiz API to perform various content management and video generation tasks. Specifically, the Generate Video operation allows users to create AI-generated videos by specifying the type of video, output format, and custom parameters that influence the video content and style.

Common scenarios for this node include:

  • Automatically generating promotional or informational videos from text and images.
  • Creating social media content in vertical or horizontal formats tailored for different platforms.
  • Customizing video generation with parameters such as voice selection, image arrays, or descriptive prompts.

For example, a marketing team could use this node to generate short vertical videos with slides containing images and text, using a specific voiceover, all automated within an n8n workflow.

Properties

Name Meaning
Video Type The kind of video to generate. Examples include "image-text-slides" (videos composed of images and text slides) or "veo3".
Output Format The orientation of the generated video. Options are: Vertical or Horizontal.
Custom Parameters A collection of key-value pairs to customize video generation. Keys can be things like "prompt" (a description for the video), "voice" (voice ID for narration), or "images" (an array of image objects with IDs and paths). Values are strings but may contain JSON strings parsed internally.

Output

The node outputs JSON data representing the response from the Postiz API after requesting video generation. This typically includes metadata about the generated video such as URLs, IDs, status, or other relevant information returned by the API.

If the API supports it, the node may also handle binary data for uploaded files or generated video content, but for the Generate Video operation, the output is primarily JSON describing the created video resource.

Dependencies

  • Requires an API key credential for authenticating with the Postiz API.
  • Uses the Postiz API endpoints to perform operations; thus, internet connectivity and valid API credentials are necessary.
  • No additional external libraries beyond those bundled with n8n and the node's dependencies.

Troubleshooting

  • Invalid or missing API credentials: Ensure that the API key credential is correctly configured in n8n.
  • Malformed custom parameters: Custom parameter values should be valid JSON strings if they represent complex objects (e.g., arrays of images). Invalid JSON will be sent as raw strings, which might cause API errors.
  • Missing required properties: The videoType and output properties are mandatory. Omitting them will cause the node to fail.
  • API errors: If the Postiz API returns errors (e.g., invalid video type, unsupported output format), check the parameters and consult the Postiz API documentation.
  • Binary data issues: For other operations involving file uploads, ensure the binary property contains valid data with expected fields (data, mimeType, fileName).

Links and References


If you need details on other operations or resources, feel free to ask!

Discussion