Overview
This node integrates with the Presenton API to generate presentations asynchronously, check the status of presentation generation tasks, and upload files for use in presentations. The primary operation, "Generate Presentation (Async)," allows users to create slide decks based on provided content, optional markdown slides, and various customization options such as tone, verbosity, theme, and output format. This is useful for automating the creation of professional or customized presentations from textual input, saving time and effort in manual slide design.
Common scenarios include:
- Automatically generating sales pitch decks from product descriptions.
- Creating educational presentations from lecture notes.
- Producing marketing presentations with a specific tone and style.
- Checking the progress of long-running presentation generation tasks.
- Uploading reference files (e.g., images or documents) to be included in presentations.
Properties
| Name | Meaning |
|---|---|
| Content | Main textual content to generate the presentation from. |
| Slides Markdown | Optional array of individual slides written in markdown format to guide slide content. |
| Instructions | Additional instructions to customize the presentation generation. |
| Tone | Writing tone/style for the presentation text. Options: Causal, Default, Educational, Funny, Professional, Sale Pitch. |
| Verbosity | Level of detail in the generated text. Options: Concise, Standard, Text Heavy. |
| Enable Web Search | Whether to allow web search during generation to enhance content. |
| Image Type | Type of images to include in slides. Options: AI Generated, Stock. |
| Theme | Optional theme name to style the presentation. |
| No of Slides | Number of slides to generate (must be a positive number). |
| Language | Language to use for the presentation content. |
| Template | Template style to apply to the presentation. |
| Include Table of Contents | Whether to include a table of contents slide. |
| Include Title Slide | Whether to include a title slide at the beginning. |
| Files (IDs From Upload) | IDs of previously uploaded files to reference in the presentation. |
| Export As | Output file format. Options: PPTX, PDF. |
Output
The node outputs JSON data containing the response from the Presenton API for each operation:
- For Generate Presentation (Async): The JSON contains details about the initiated presentation generation task, including a task ID that can be used to check status later.
- For Check Presentation Status: The JSON includes the current status of the presentation generation task, such as whether it is completed or still processing.
- For Upload File: The JSON contains information about the uploaded file, including its assigned ID for future reference.
No binary data is output by this node; all results are returned as JSON objects representing API responses.
Dependencies
- Requires an API key credential for authenticating with the Presenton API.
- Uses HTTP requests to the Presenton API endpoints for asynchronous presentation generation, status checking, and file uploads.
- No additional environment variables are explicitly required beyond the API authentication.
Troubleshooting
- Invalid number of slides error: If the "No of Slides" property is not a positive number, the node throws an error. Ensure this value is a positive integer.
- Missing Task ID error: When checking status, a valid task ID must be provided. An empty or missing task ID will cause an error.
- Missing binary data error: When uploading a file, the specified binary property must exist on the input item. Verify the binary property name and ensure the input contains binary data.
- API request failures: Network issues or invalid API credentials may cause errors. Confirm API key validity and network connectivity.
- Empty or null parameters: The node removes any parameters that are empty strings, null, or empty arrays before sending the request. Make sure required fields are properly set.
Links and References
- Presenton API Documentation (Replace with actual URL if available)
- n8n Documentation on Creating Custom Nodes
- General info on Presentation Automation Tools