# 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

```json
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

```json
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

```json
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](https://help.blotato.com/api/visuals/ba413be6-a840-4e60-8fd6-0066d3b427df)
* [Quote Card with Paper Background](https://help.blotato.com/api/visuals/f941e306-76f7-45da-b3d9-7463af630e91)

## See Also

* [Create Visual API Reference](https://help.blotato.com/api/create-video)
* [All Visual Templates](https://help.blotato.com/api/visuals)