Overview
This node enables video generation based on user-defined prompts and various customizable parameters. It is designed to create videos from textual descriptions, optionally using reference images for the first and last frames. Users can specify video duration, frame rate, resolution, aspect ratio, and whether to include background music or a watermark. The node supports different generation modes prioritizing either speed or quality.
Practical scenarios include:
- Creating short promotional or social media videos from simple text prompts.
- Generating illustrative videos for storytelling or educational content.
- Producing customized video clips with specific visual styles by providing reference images.
Properties
| Name | Meaning |
|---|---|
| 提示词 (prompt) | Text prompt describing the video content to generate, e.g., "A cute cat walking in flowers". |
| 首帧图 (image_url) | URL or Base64 string of the reference image for the first frame of the video (ignored in some modes). |
| 尾帧图 (image_url1) | URL or Base64 string of the reference image for the last frame of the video (ignored in some modes). |
| 视频时长 (duration) | Video length option: 5 seconds or 10 seconds. |
| 音乐 (generation_ai_audio) | Boolean flag to include AI-generated background music in the video. |
| 水印 (label_watermark) | Boolean flag to add a watermark overlay on the video. |
| 生成模式 (generation_pattern) | Video generation mode: prioritize speed ("速度更快") or quality ("质量更佳"). |
| 帧率 (fps) | Frame rate setting: 30 FPS or 60 FPS. |
| 分辨率 (resolution) | Video resolution: 720P, 1080P, or 4K. |
| 屏幕比例 (aspect_ratio) | Aspect ratio of the video: 16:9, 9:16, 1:1, 4:3, or 3:4. |
| 是否等待视频生成 (generate) | Boolean flag indicating whether to wait for the video generation process to complete before continuing. |
Output
The node outputs JSON data representing the result of the video generation operation. This typically includes metadata about the generated video such as URLs or identifiers to access the created video file. If binary data output is supported, it would represent the actual video content or related media files.
Dependencies
- Requires an API key credential for authentication with the external video generation service.
- The node depends on an external plugin or resource factory to build its properties and handle the video generation logic.
- Network access to the referenced image URLs (if provided) is necessary.
- Proper configuration of the API credentials within n8n is required for successful operation.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect or inaccessible image URLs may lead to errors or ignored reference frames.
- Selecting incompatible combinations of resolution, frame rate, or duration might cause generation failures.
- Network connectivity problems can interrupt communication with the video generation service.
Error messages:
"未实现方法: 视频生成.视频生成"indicates that the requested resource-operation combination is not implemented; verify correct resource and operation names.- Errors during the call function are logged with details; enabling continue-on-fail allows processing subsequent items despite individual failures.
Resolutions:
- Ensure valid API credentials are configured.
- Verify URLs for reference images are accessible and correctly formatted.
- Use supported property values as per the node's options.
- Check network connectivity and retry if transient errors occur.
Links and References
- No direct external links were found in the source code or property definitions.
- For more information on video generation APIs or similar services, consult the documentation of the integrated external service used by this node (not specified here).