What You’ll Learn
Brand Presets
Use saved brand configurations by name
Consistent Branding
Apply uniform styling across all videos
Quick Production
Speed up video creation with presets
Multi-Brand Support
Manage multiple brand identities
Before You Begin
Make sure you have:- A Pictory API key (get one here)
- Node.js or Python installed on your machine
- Brand preset created in your Pictory account
- Brand preset name from your Pictory settings
How Brand Presets Work
When you apply a brand preset to your video:- Brand Selection - You specify your brand preset by name
- Style Application - All brand settings are automatically applied
- Consistent Elements - Logos, colors, fonts, and styles are unified
- Automatic Formatting - Subtitles, intro/outro, and layouts use brand settings
- Video Creation - Your video is created with complete brand consistency
Brand presets must be created in your Pictory account before using them via the API. You can create and manage brand presets through the Pictory web interface under Brand Settings.
Complete Example
Understanding the Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
videoName | string | Yes | A descriptive name for your video project |
brandName | string | Yes | Exact name of your saved brand preset from Pictory account |
scenes | array | Yes | Video scene configuration (story text, scene creation rules) |
Brand Preset Components
Brand presets automatically apply these elements to your videos:| Element | What It Includes | Example |
|---|---|---|
| Logo | Position, size, opacity, and placement | Company logo in top-right corner |
| Colors | Primary and secondary brand colors | Specific hex codes for consistency |
| Fonts | Text styling and typography | Branded font families and sizes |
| Intro/Outro | Branded opening and closing sequences | 5-second branded intro video |
| Subtitle Styles | Consistent caption formatting | Font, color, position, animations |
| Voice Settings | Preferred AI voice configuration | Specific voice, speed, volume |
Finding Your Brand Presets
Option 1: Using the Pictory Web Interface
- Log in to your Pictory account
- Navigate to Brand Kits or Brand Settings
- View your saved brand presets
- Note the exact brand name to use in your API calls
Option 2: Using the API
Retrieve all your brand presets programmatically:Common Use Cases
Maintaining Brand Consistency
Quick Video Production
Multi-Brand Management
Team Collaboration
Best Practices
Create Multiple Brand Presets
Create Multiple Brand Presets
Organize brand presets for different use cases:
- Corporate: Professional presentations and announcements
- Social Media: Casual content for Instagram, TikTok, LinkedIn
- Training: Educational and internal training videos
- Marketing: Promotional and sales videos
- Events: Conference and webinar content
Use Descriptive Brand Names
Use Descriptive Brand Names
Name your brand presets clearly:
- Good: “Corporate - Blue Theme”, “Social - Casual Style”
- Avoid: “Brand1”, “Test”, “New”
Test Brand Presets Before API Use
Test Brand Presets Before API Use
Before using a brand preset via the API:
- Create a test video in the Pictory web interface
- Verify all brand elements appear correctly
- Confirm colors, fonts, and logos are as expected
- Make any adjustments in the brand settings
- Then use the finalized preset in your API calls
Keep Brand Presets Updated
Keep Brand Presets Updated
Maintain your brand presets over time:
- Update logos when branding changes
- Refresh color schemes seasonally if needed
- Adjust subtitle styles based on platform trends
- Test updated presets before using in production
- Document changes for your team
Document Brand Preset Usage
Document Brand Preset Usage
Create a reference guide for your team:
- List all available brand presets with descriptions
- Specify which preset to use for which content type
- Include example API requests for common scenarios
- Note any special requirements or restrictions
- Update documentation when adding new presets
Troubleshooting
Error: Brand not found
Error: Brand not found
Problem: API returns an error that the brand preset doesn’t exist.Solution:
- Verify the brand name is spelled exactly as saved in Pictory
- Check for case sensitivity (e.g., “Corporate” vs “corporate”)
- Use the Get Video Brands API to see all available presets
- Ensure the brand preset exists in your account
- Try copying the name directly from the Pictory interface
Brand elements not appearing in video
Brand elements not appearing in video
Problem: Video doesn’t show logo, colors, or other brand elements.Solution:
- Check that the brand preset is fully configured in Pictory
- Verify all brand elements are saved in the preset
- Test the preset in the Pictory web interface first
- Ensure the preset includes the specific elements you expect
- Review the completed video - some elements may be subtle
Brand preset works in UI but not via API
Brand preset works in UI but not via API
Problem: Brand works in Pictory interface but not through API calls.Solution:
- Confirm you’re using the exact brand name (check spelling and case)
- Use the Get Video Brands API to retrieve the correct name
- Ensure your API key has access to that brand preset
- Check that the preset hasn’t been deleted or renamed
- Verify no special characters or extra spaces in the name
Wrong brand applied to video
Wrong brand applied to video
Problem: Video uses a different brand preset than specified.Solution:
- Double-check the
brandNameparameter in your request - Ensure you’re not overriding brand elements with other parameters
- Verify the brand name is in quotes and properly formatted
- Check for typos or autocomplete errors in your code
- Review the request payload before sending
Cannot access brand presets
Cannot access brand presets
Problem: Get Video Brands API returns empty or errors.Solution:
- Confirm you’ve created brand presets in your Pictory account
- Check that your API key is valid and active
- Ensure you’re using the correct API endpoint
- Verify your account has access to brand features
- Contact support if the issue persists
Next Steps
Explore more branding customization options:Custom Logo
Add and position logos without brand presets
Subtitle Styles
Apply saved subtitle styling to videos
Custom Subtitle Style
Create inline subtitle styles without presets
Highlight Keywords
Emphasize important words in subtitles
API Reference
For complete technical details, see:- Get Video Brands - List all your brand presets
- Render Storyboard Video - Full API specification
- Get Job Status - Monitor job status and progress
