Menu

video-generator api settings guide

Guide: All Settings of the Simple Video Generator Explained ⚙️

Mar 05, 2025 By samautomation
Guide: All Settings of the Simple Video Generator Explained ⚙️

Guide: All Settings of the Simple Video Generator Explained ⚙️

IMPORTANT: These settings only work with the Simple Video Generator API endpoint (/api/function/video-generation/simple-video) and NOT with the standard video generator.

The Simple Video Generator offers numerous options to personalize your videos. In this guide, we'll explain all available settings so you can get the most out of the tool!

Watermark Settings: Make Your Videos Recognizable

The Simple Video Generator has extensive options for adding your own logo or watermark to videos:

  • watermark_url

    The URL to your logo or watermark image.

    This can be a local path or a URL to an online image. Supported formats: PNG, JPG, JPEG.

    Example: "watermark_url": "https://example.com/logo.png"

  • watermark_position

    The position of the watermark in the video.

    Supported values: top-left, top-right, bottom-left, bottom-right, center.

    Example: "watermark_position": "bottom-right"

  • watermark_size

    The size of the watermark relative to the video.

    A numeric value between 0.01 and 1.0, where 1.0 would cover the entire width/height of the video.

    Example: "watermark_size": 0.1 (10% of the video width)

  • watermark_as_ending

    Whether the watermark should be added as an Instagram-style ending screen.

    When set to true, a professional branding moment is added at the end of the video.

    Example: "watermark_as_ending": true

  • watermark_ending_duration

    The duration of the ending screen in seconds (only applicable if watermark_as_ending=true).

    A numeric value, usually between 1 and 5 seconds. Recommended: 2-3 seconds.

    Example: "watermark_ending_duration": 2.0

Video Quality and Performance Settings

Adjust the quality and performance of your generated videos:

  • output_quality

    The quality of the final video.

    Supported values: low, medium, high, very_high.

    Higher quality results in larger files and longer processing time.

    Example: "output_quality": "medium"

  • fps

    Frames per second for the generated video.

    Standard values: 24, 25, 30, or 60. Higher FPS gives smoother video but larger files.

    Example: "fps": 24

Complete Example of Settings

Here's a full example of all settings together:

{
  "settings": {
    "watermark_url": "Your image URL",
    "watermark_position": "center",
    "watermark_size": 0.1,
    "output_quality": "medium",
    "watermark_as_ending": true, 
    "watermark_ending_duration": 2.0, 
    "fps": 24
  }
}

Detailed Explanation of the Above Example

Let's look at each of these settings in detail:

  1. watermark_url: This URL refers to an image stored in AWS S3. This image is used as a watermark/logo in the video.

  2. watermark_position: Set to "center" means that the watermark is placed in the middle of the video when used as a regular watermark.

  3. watermark_size: The value 0.1 means that the watermark takes up 10% of the width of the video, providing a subtle but visible logo.

  4. output_quality: The "medium" setting offers a good balance between file size and visual quality.

  5. watermark_as_ending: Set to "true" means that an Instagram-style ending screen will be added at the end of the video.

  6. watermark_ending_duration: The 2.0 seconds is an optimal duration for the ending screen - long enough to make an impact but not so long that viewers disengage.

  7. fps: 24 frames per second is the standard for cinematic content and provides a good balance between smoothness and file size.

Pro Tips for Using the Simple Video Generator

⭐ Pro Tips

  • For social media, use a higher FPS (30 or 60) for a modern, smooth look
  • Choose a subtle watermark (size 0.05-0.1) for continuous branding
  • Combine a subtle watermark with an ending screen for the best branding strategy
  • Use transparent PNGs for your watermark for a professional result
  • Test different watermark positions to create the best viewing experience

Do you have questions about the Simple Video Generator settings or suggestions for new features? Let us know!

Related Articles

← Back to Blog