# Combine Clips and Apply Basic Edits

Stitch video clips together with titles, captions, background music, and transitions.

## When to Use This Template

* You have your own video clips (recorded on your phone, from a camera, or downloaded) and want to stitch them together into one video
* You want to add a title card, auto-generated captions, background music, or transitions to existing footage
* You are a content creator, real estate agent, or business owner who films your own clips and needs light editing before posting to TikTok, Instagram Reels, or YouTube Shorts
* You do NOT need AI to generate any visuals -- you are bringing your own footage

## Template Information

| Property    | Value                                                            |
| ----------- | ---------------------------------------------------------------- |
| Template ID | `/base/v2/combine-clips/c306ae43-1dcc-4f45-ac2b-88e75430ffd8/v1` |
| Output Type | Video                                                            |
| Category    | Video Editor                                                     |

## Parameters

| Parameter                 | Type    | Required | Default         | Description                                            |
| ------------------------- | ------- | -------- | --------------- | ------------------------------------------------------ |
| videoClips                | array   | Yes      | -               | Video clips to stitch. Min: 1, Max: 20                 |
| videoClips\[].url         | video   | Yes      | -               | URL of video clip                                      |
| trimSilence               | boolean | No       | false           | Trim silence at start/end                              |
| titleConfig               | object  | No       | -               | Title overlay configuration                            |
| titleConfig.enabled       | boolean | No       | false           | Enable title overlay                                   |
| titleConfig.text          | string  | No       | Your Title Here | Title text                                             |
| titleConfig.position      | enum    | No       | top             | Values: top, center, bottom                            |
| titleConfig.duration      | number  | No       | 4               | Seconds to display. Range: 1-10                        |
| titleConfig.style         | enum    | No       | minimal         | Values: minimal, bold, elegant, modern                 |
| captionsConfig            | object  | No       | -               | Captions configuration                                 |
| captionsConfig.enabled    | boolean | No       | false           | Enable captions                                        |
| captionsConfig.style      | enum    | No       | minimal         | Values: minimal, bold, highlight, tiktok               |
| captionsConfig.position   | enum    | No       | bottom          | Values: top, center, bottom                            |
| musicConfig               | object  | No       | -               | Background music configuration                         |
| musicConfig.enabled       | boolean | No       | false           | Enable background music                                |
| musicConfig.url           | string  | No       | -               | Music file URL (MP3/WAV)                               |
| musicConfig.volume        | number  | No       | 30              | Volume level. Range: 0-100                             |
| transitionConfig          | object  | No       | -               | Transition configuration                               |
| transitionConfig.type     | enum    | No       | none            | Values: none, fade, crossfade, slide, zoom             |
| transitionConfig.duration | number  | No       | 0.5             | Seconds. Range: 0-2                                    |
| maxDuration               | number  | No       | 0               | Max output duration in seconds. 0 = no limit. Max: 600 |
| aspectRatio               | enum    | No       | 9:16            | Values: 16:9, 9:16, 1:1, 4:5                           |

## Example 1: Basic Clip Combination

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

{
  "templateId": "/base/v2/combine-clips/c306ae43-1dcc-4f45-ac2b-88e75430ffd8/v1",
  "inputs": {
    "videoClips": [
      { "url": "https://example.com/clip1.mp4" },
      { "url": "https://example.com/clip2.mp4" },
      { "url": "https://example.com/clip3.mp4" }
    ],
    "aspectRatio": "9:16"
  },
  "render": true
}
```

## Example 2: Full Featured Edit

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

{
  "templateId": "/base/v2/combine-clips/c306ae43-1dcc-4f45-ac2b-88e75430ffd8/v1",
  "inputs": {
    "videoClips": [
      { "url": "https://example.com/intro.mp4" },
      { "url": "https://example.com/main-content.mp4" },
      { "url": "https://example.com/outro.mp4" }
    ],
    "trimSilence": true,
    "titleConfig": {
      "enabled": true,
      "text": "My Amazing Video",
      "position": "center",
      "duration": 3,
      "style": "bold"
    },
    "captionsConfig": {
      "enabled": true,
      "style": "tiktok",
      "position": "bottom"
    },
    "musicConfig": {
      "enabled": true,
      "url": "https://example.com/background-music.mp3",
      "volume": 25
    },
    "transitionConfig": {
      "type": "crossfade",
      "duration": 0.5
    },
    "maxDuration": 60,
    "aspectRatio": "9:16"
  },
  "render": true
}
```

## Example 3: With Captions and Transitions

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

{
  "templateId": "/base/v2/combine-clips/c306ae43-1dcc-4f45-ac2b-88e75430ffd8/v1",
  "inputs": {
    "videoClips": [
      { "url": "https://example.com/clip1.mp4" },
      { "url": "https://example.com/clip2.mp4" }
    ],
    "captionsConfig": {
      "enabled": true,
      "style": "highlight",
      "position": "center"
    },
    "transitionConfig": {
      "type": "fade",
      "duration": 0.8
    },
    "aspectRatio": "1:1"
  },
  "render": true
}
```

## Related Templates

* [AI Video with AI Voice](https://help.blotato.com/api/visuals/5903fe43-514d-40ee-a060-0d6628c5f8fd)
* [AI Avatar with AI Generated B-roll](https://help.blotato.com/api/visuals/7c26a1cd-d5b3-42da-9c73-2413333873b3)

## See Also

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