Tweet Card with Photo/Video Background

Create Twitter/X-style quote cards with a photo or video background.

When to Use This Template

• Same as the minimal tweet card, but with your own photo or video as the background behind each tweet card

• You want a more visual, branded look for tweet-style quote carousels

• Useful for lifestyle, travel, or fitness creators who want tweet quotes overlaid on their own imagery

Template Information

Property	Value
Template ID	/base/v2/tweet-card/9714ae5c-7e6b-4878-be4a-4b1ba5d0cd66/v1
Output Type	Slideshow
Category	Tweet Cards

Parameters

Parameter	Type	Required	Default	Description
backgroundMedia	image	No	-	Background image or video URL
quotes	array	Yes	-	List of quotes. Min: 1, Max: 100. Each: 10-280 chars
authorName	string	Yes	Dean Graziosi	Name of person quoted. Max: 60 chars
handle	string	Yes	deangraziosi	Social handle without @. Max: 50 chars
profileImage	image	No	-	Profile photo URL
theme	enum	No	light	Values: light, dark
cardPosition	enum	No	bottom	Values: top, middle, bottom
verified	boolean	No	true	Show verified badge
enableBackdropBlur	boolean	No	false	Add blur effect behind card
accentColor	color	No	#C4A484	Background shape color
cardBackgroundColor	color	No	#FFFFFF	Card background color
textColor	color	No	#0F1419	Quote text color
aspectRatio	enum	No	4:5	Values: 4:5, 1:1, 9:16

Example 1: AI-Powered with Prompt

POST https://backend.blotato.com/v2/videos/from-templates
Content-Type: application/json
blotato-api-key: YOUR_API_KEY

{
  "templateId": "/base/v2/tweet-card/9714ae5c-7e6b-4878-be4a-4b1ba5d0cd66/v1",
  "inputs": {},
  "prompt": "Create 4 inspirational tweet cards about perseverance with mountain scenery backgrounds",
  "render": true
}

Example 2: Manual Inputs

POST https://backend.blotato.com/v2/videos/from-templates
Content-Type: application/json
blotato-api-key: YOUR_API_KEY

{
  "templateId": "/base/v2/tweet-card/9714ae5c-7e6b-4878-be4a-4b1ba5d0cd66/v1",
  "inputs": {
    "backgroundMedia": "https://images.unsplash.com/photo-1506905925346-21bda4d32df4",
    "quotes": [
      "Be careful who you let speak into your life.",
      "People will question your choices.",
      "Take advice from people who have receipts."
    ],
    "authorName": "Dean Graziosi",
    "handle": "deangraziosi",
    "theme": "light",
    "cardPosition": "bottom",
    "enableBackdropBlur": true,
    "accentColor": "#C4A484",
    "aspectRatio": "4:5"
  },
  "render": true
}

Example 3: Hybrid Approach

POST https://backend.blotato.com/v2/videos/from-templates
Content-Type: application/json
blotato-api-key: YOUR_API_KEY

{
  "templateId": "/base/v2/tweet-card/9714ae5c-7e6b-4878-be4a-4b1ba5d0cd66/v1",
  "inputs": {
    "backgroundMedia": "https://example.com/nature-background.jpg",
    "authorName": "Your Brand",
    "handle": "yourbrand",
    "cardPosition": "middle",
    "enableBackdropBlur": true
  },
  "prompt": "Generate 5 quotes about work-life balance",
  "render": true
}

Related Templates

• Tweet Card with Minimal Style

• Quote Card with Paper Background

See Also

• Create Visual API Reference

• All Visual Templates