Actions7
- Brand Actions
- Image Actions
- Project Actions
- Text Actions
- Video Actions
Overview
The node integrates with the Marketing Architects API to generate videos based on textual prompts and optional parameters. It is designed to create custom videos by specifying a model, prompt, and various video generation options such as aspect ratio, resolution, and start images. This node is useful for marketing teams, content creators, or developers who want to automate video creation from descriptive text inputs.
Typical use cases include:
- Generating promotional videos from marketing copy.
- Creating social media content automatically from text descriptions.
- Producing video assets for presentations or advertisements without manual video editing.
For example, a user can input a prompt like "a cute panda eating in the forest" and specify a 16:9 aspect ratio and 720p resolution to generate a short video matching that description.
Properties
| Name | Meaning |
|---|---|
| Model | The video generation model to use. Choose from a list of available models or specify an ID via expression. |
| Prompt | The textual description used to generate the video content. |
| Options | Additional video generation settings: |
| - Aspect Ratio | The video's aspect ratio. Options: 16:9, 9:16. |
| - Image | A starting reference image URL or base64 string to guide video generation (specific to Veo). |
| - Negative Prompt | Text describing what should be excluded from the video generation. |
| - Resolution | Video resolution. Options: 720p, 1080p. |
| - Start Image | Another field for a starting reference image to influence video generation. |
| Retry Settings | Configuration for retrying the request on failure: |
| - Enable Retry on Failure | Whether to retry if the request fails (true/false). |
| - Max Retry Attempts | Maximum number of retry attempts (1-10). |
| - Retry Delay (Seconds) | Delay between retries in seconds (1-60). |
| - Backoff Strategy | Strategy for delay between retries: fixed or exponential. |
Output
The node outputs JSON data representing the generated video information returned by the Marketing Architects API. This typically includes metadata about the created video, such as URLs to access the video file, status, and any relevant identifiers.
If the API supports binary data output (e.g., direct video file), it would be handled accordingly, but based on the static analysis, the output is primarily JSON metadata referencing the generated video.
Dependencies
- Requires an API key credential for authenticating with the Marketing Architects API.
- The node sends HTTP POST requests to the endpoint
/video/replicateon the Marketing Architects API base URL. - No other external dependencies are indicated.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect model IDs or unsupported prompt formats may result in errors or empty video outputs.
- Network issues or API downtime could cause request failures.
Error messages:
- Errors returned by the API are processed by a generic error handler (
sendErrorPostReceive), which surfaces meaningful messages. - If retries are enabled, transient errors may be retried automatically according to configured settings.
- Errors returned by the API are processed by a generic error handler (
Resolutions:
- Verify API key validity and permissions.
- Ensure the selected model exists and is compatible with video generation.
- Adjust retry settings to handle intermittent network or service issues.
Links and References
- Marketing Architects API Documentation (base URL referenced)
- n8n Expressions Documentation: https://docs.n8n.io/code/expressions/ (for dynamic property values)