Overview
This node integrates with the edero.ai API to create long story videos narrated with a custom voice. It is designed to transform a full story text into a narrated video, allowing users to customize various aspects such as the title, narration voice, visual style, aspect ratio, subtitles, and animations. This node is beneficial for content creators, educators, marketers, or storytellers who want to generate engaging video content from textual stories without manual video editing.
Practical examples include:
- Creating narrated story videos for YouTube or social media.
- Generating educational videos with custom narration and visuals.
- Producing promotional or explainer videos with tailored voice and style.
Properties
| Name | Meaning |
|---|---|
| Title | Title of the long story video. |
| Story | The full story text to be narrated in the video. |
| Description | Optional description of the video content. |
| Voice Settings | Settings for the narration voice including: |
| - Voice ID: Identifier for the voice to use. | |
| - Stability: Voice stability level (0 to 1). | |
| - Clarity: Voice clarity level (0 to 1). | |
| Aspect Ratio | Aspect ratio of the video, e.g., "16:9" or "9:16". |
| Visual Style | Visual style for the video, e.g., "realistic", "cartoon". |
| Subtitle Style | Style of subtitles displayed, e.g., "default", "minimal", "styled". |
| Custom Prompt | Custom prompt text used to generate visuals related to the story, e.g., "futuristic cityscape". |
| Context Image Url | URL to an image providing context for visual generation. |
| Skip Animations | Boolean flag to skip animations in the generated video. |
Output
The node outputs JSON data representing the result of the long story video creation request. This typically includes metadata about the generated video, such as URLs to the video file or status information. If the node supports binary output (e.g., the actual video file), it would be included in the binary data output, but this is not explicitly detailed in the provided code.
Dependencies
- Requires an API key credential for authenticating with the edero.ai API.
- The node sends requests to the edero.ai service endpoint specified in the credentials.
- Proper configuration of the API base URL and authentication token is necessary within n8n credentials.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect or unsupported voice IDs may result in errors or default voice usage.
- Providing invalid URLs for the context image might lead to visual generation failures.
- Exceeding API rate limits or quota can cause request rejections.
Error messages:
- Authentication errors usually indicate problems with the API key or URL.
- Validation errors may occur if required fields like Title or Story are empty.
- Network or timeout errors suggest connectivity issues with the edero.ai service.
Resolutions:
- Verify that the API key and base URL are correctly set in the credentials.
- Ensure all required properties are filled with valid values.
- Check network connectivity and retry after some time if rate limits are hit.
Links and References
- edero.ai Official Website — For API documentation and account setup.
- n8n Documentation on Creating Custom Nodes — For understanding node development basics.