Scrptly
Generates an AI video based on a text prompt and optional context images. Returns the video URL when done.
Overview
This node integrates with the Scrptly API to generate AI videos based on a user-provided text prompt and optional context images. It is useful for automating video creation workflows where videos are generated dynamically from textual descriptions and visual context. For example, marketing teams can use it to create promotional videos from product descriptions and images, or content creators can generate video content from scripts and related visuals.
Use Case Examples
- Generate a video from a product description and a set of product images.
- Create a video summary from a text script with supporting images.
- Automate video content creation for social media posts using text prompts and context images.
Properties
| Name | Meaning |
|---|---|
| Prompt | The text prompt describing the content of the video to be generated. |
| Context Images | An array of images with URLs and optional descriptions to provide visual context for the video generation. |
| Max Tokens to Approve | The maximum token budget the user is willing to approve for the video generation process. This controls the cost and resource usage. |
| Wait For Completion | Whether the node should wait for the video generation to complete before returning the result, or return immediately with the task ID. |
Output
JSON
taskId- The unique identifier of the video generation task (when not waiting for completion).statusUrl- The URL to check the status of the video generation task (when not waiting for completion).startResponse- The initial response from the API when starting the video generation task.status- The final status of the video generation task (e.g., 'success').statusMessage- A message describing the final status of the task.projectUrl- The URL of the generated video project.projectId- The unique identifier of the generated video project.videoUrl- The URL of the generated video file.thumbnailUrl- The URL of the thumbnail image for the generated video.
Dependencies
- Requires an API key credential for the Scrptly API to authenticate requests.
Troubleshooting
- If the node throws an error 'Scrptly: failed to start video generation', check that the API key credential is valid and has sufficient permissions and funds.
- If the task status returns 'failed', the node will throw an error with the failure message. Verify the prompt and context images are valid and retry.
- If the node is set to wait for completion, it polls the status every 15 seconds. Network issues or API rate limits may cause delays or failures.
- Ensure the 'Max Tokens to Approve' value is set according to your account's available balance to avoid rejection due to insufficient funds.