​
What are Templates?

Templates are pre-designed video structures that define the visual style, animations, layout, and AI generation parameters for your videos. Each template is optimized for specific use cases like social media content, Discord conversations, explainer videos, or UGC-style content.

​
Template Structure

Every template includes:

Visual Design

Layout, typography, colors, and animations

AI Configuration

Script generation prompts and voice settings

Asset Requirements

Required and optional media inputs

Timing

Duration ranges and scene transitions

​
Available Templates

​
Entertainment Templates

Template ID: consumerclub-discord-zoomedBest for: Viral Discord conversation contentDescription: Super zoomed-in Discord messages with tech CEO personalities (Musk, Bezos, Zuck, Jensen, Sam Altman). Same author stacks messages, different author clears screen for high engagement.Duration: 35-45 messages (dynamic, match-audio)Credits: 5 per videoKey Features:
  • Multi-character tech CEO voices (gender-based selection)
  • Discord-style UI with black background
  • Background video (Minecraft parkour)
  • Channel icon generation
Example use cases:
  • Tech industry commentary
  • Viral Discord meme videos
  • TikTok/Shorts entertainment
Required context:
{
  "prompt": "Create a Discord conversation about [topic]"
}
Template ID: rick-morty-explainerBest for: High-retention educational content with humorDescription: Educational/commentary videos featuring Rick & Morty dialogue, reaction memes, and engaging background footage. Optimized for TikTok engagement.Duration: 35-45 seconds (7-9 dialogue lines)Credits: 5 per videoKey Features:
  • Rick & Morty custom character voices
  • 7 GIF reaction memes
  • Background video (Minecraft/gaming)
  • Educational focus with entertainment value
Example use cases:
  • Educational explainers
  • Social commentary
  • Viral TikTok/Instagram Reels
Required context:
{
  "prompt": "Explain [topic] in a funny way"
}

​
Educational Templates

Template ID: cat-explainer-v2Best for: “Explained by Cats” educational contentDescription: Educational videos with line-based image generation using a reference cat character for consistency. Features continuous narrator voiceover with ”✨ explained by cats ✨” branding.Duration: 40-50 seconds (8 narration lines)Credits: 5 per videoKey Features:
  • Reference cat image from asset collection
  • Line-by-line AI image generation (8 sequences)
  • Topic + accent image pairs
  • Professional narrator voice (Adam)
  • Branded format
Example use cases:
  • Educational content for kids/families
  • Explainer videos with personality
  • Social media educational content
Required context:
{
  "prompt": "Explain [topic] in simple terms"
}
Template ID: steel-griffin-explainerBest for: Educational content with expert dialogueDescription: Educational videos featuring expert dialogue between Marcus (Plant Manager) and Tech (Metallurgical Engineer), with reaction memes and industrial focus. Uses Peter Griffin & Brian Griffin voices.Duration: 35-45 seconds (7-9 dialogue lines)Credits: 5 per videoKey Features:
  • Expert character dialogue (Marcus & Tech)
  • Peter Griffin & Brian Griffin voices
  • 7 GIF reaction memes
  • Industrial/manufacturing focus
  • Background video with configurable character images
Example use cases:
  • Educational explainers
  • Manufacturing/industrial content
  • Professional commentary
Required context:
{
  "prompt": "Explain [industrial/technical topic]"
}

​
UGC Templates

Template ID: ugc-text-overlayBest for: Authentic TikTok-style UGC contentDescription: UGC video with TikTok-style text overlay. AI-generated video using Seedream-4 + Kling with authentic compressed TikTok aesthetic.Duration: 5 seconds (fixed)Credits: 5 per videoKey Features:
  • Seedream-4 + Kling video generation
  • Casual texting-style text overlay (56-72 words)
  • 3 CAPS words for emphasis (mandatory)
  • Reference person image from asset pool
  • No voice generation (visual only)
  • Authentic 720p @ 20fps TikTok feel
Example use cases:
  • UGC-style product reviews
  • Social proof content
  • Authentic testimonial videos
Required context:
{
  "prompt": "Create UGC content about [topic/product]"
}

​
Template Properties

​
Get Template Details

curl https://api.getbluma.com/api/v1/templates/consumerclub-discord-zoomed \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "consumerclub-discord-zoomed",
  "name": "ConsumerClub Discord Zoomed",
  "description": "Super zoomed-in Discord messages with tech CEO personalities",
  "category": "entertainment",
  "credits_per_video": 5,
  "ai_features": {
    "script_generation": true,
    "voice_generation": true,
    "image_generation": true
  }
}
All templates cost 5 credits per video, regardless of complexity. Custom variants created by users also cost 5 credits.

​
Using Templates

​
Basic Usage

curl -X POST https://api.getbluma.com/api/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "rick-morty-explainer",
    "context": {
      "prompt": "Explain why cats always land on their feet"
    }
  }'

​
With Brand Customization

curl -X POST https://api.getbluma.com/api/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "ugc-text-overlay",
    "context": {
      "prompt": "Create authentic UGC content about our new wireless headphones",
      "brand_id": "brand_abc123"
    }
  }'

​
Credit Pricing

All templates cost 5 credits per video (equivalent to $5 USD). This flat pricing includes:
  • Script generation (AI)
  • Voice generation (text-to-speech)
  • Image generation (where applicable)
  • Video processing and rendering
  • All AI features and processing
Template Variants: User-created variants based on default templates also cost 5 credits per video, with no additional charges.

​
Template Customization

Custom Templates are available for Enterprise plans. Contact sales@getbluma.com to discuss custom template development.

​
Branding

Apply your brand identity to any template: 
{
  "template_id": "any-template",
  "context": {
    "brand_id": "your_brand_id"
  }
}
This automatically applies:
  • Brand colors
  • Logo placement
  • Custom fonts
  • Brand voice guidelines

​
Template Variants

Users can create custom variants of default templates with different configurations. Variants cost the same as the base template (5 credits) regardless of customization. Example variant usage: 
{
  "template_id": "your-custom-variant-id",
  "context": {
    "prompt": "Your custom prompt"
  }
}
Variants can include:
  • Custom character personalities
  • Different visual styles
  • Modified durations
  • Alternative voice settings
  • Custom asset pools
All variants are priced at 5 credits per video, the same as default templates.

​
Custom Data

Some templates accept custom data for advanced customization: 
{
  "template_id": "advanced-template",
  "context": {
    "custom_data": {
      "background_color": "#FF5733",
      "music_style": "upbeat",
      "call_to_action": "Shop Now"
    }
  }
}

​
Best Practices

Match Content to Template

Choose templates that align with your content type and platform

Test with Test Keys

Experiment with different templates using test API keys before production

Monitor Credits

Track credit usage per template to optimize costs

Use Webhooks

Set up webhooks to be notified when videos are ready

​
Frequently Asked Questions

Yes! Custom template development is available for Enterprise customers. Contact sales@getbluma.com to discuss your requirements.
We release new templates monthly. Follow our changelog for updates.
Templates are fixed structures, but you can customize them through brand settings and custom_data parameters. For deeper modifications, consider a custom template.
Check the error message for details. Common issues include invalid prompts, insufficient credits, or unsupported custom_data. See Error Handling for more information.

​
Next Steps

Browse All Templates

View the complete template catalog via API

Generate Your First Video

Step-by-step guide to creating your first video

Credit System

Learn how credits and pricing work

Best Practices

Optimize your template usage