🚀 New Feature: Background Visual Filter in Text-to-Video API

We’re excited to introduce a powerful new capability in our Text-to-Video API – the backgroundVisualFilter object!

With this new feature, developers can now fine-tune the auto-selected background visuals in their generated videos by specifying a category filter. This gives you greater creative control and ensures your videos are even more aligned with your content and audience.

🔍 What's New?

• New Attribute: backgroundVisualFilter
• Field: category – Use this to refine visual background selection by content category.

🎯 Supported Categories

• You can now filter visuals by a wide array of categories and subcategories, such as:
• Aerial (e.g., Natural Landscapes, Urban Landscapes)
• Animals (e.g., Wildlife, Pets, Marine Life)
• Business and Professions (e.g., Office Work, Professions)
• Effects (e.g., Fire and Smoke, Glitches, Lighting Effects)
• Food and Beverage (e.g., Meals, Food Preparation)
• Graphics, Historical, Holidays and Celebrations, Lifestyle, Medical, Nature, People, Places and Landmarks, Sports and Recreation, Technology, and many more.

The full list of available values is extensive to support a wide range of use cases – from corporate explainers to travel reels, educational content, and beyond.

✅ Example Usage

{
  "backgroundVisualFilter": {
    "category": "Nature/Waterfalls"
  }
}

This would guide the API to prioritize background visuals related to waterfalls, helping your content feel more relevant and immersive.

📘 Learn More

Check out our API documentation for the full list of supported categories and implementation details.

We can’t wait to see the creative videos you build with this new capability! As always, feel free to reach out with feedback or questions.

Happy building!