> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/api/visual/ai-avatar-with-ai-generated-b-roll.md).

# AI Avatar with AI Generated B-roll

> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/api/visuals/7c26a1cd-d5b3-42da-9c73-2413333873b3.md).

## AI Avatar with AI Generated B-roll

Create AI avatar videos with automatically generated B-roll footage that complements the narration.

### When to Use This Template

* You have a talking head video (from HeyGen, a webcam, or your phone) and want to add AI-generated b-roll footage that matches your narration
* You are a coach, educator, or thought leader who records yourself speaking and wants to make the video more engaging with relevant visuals
* You want to enhance existing avatar or webcam footage for LinkedIn, YouTube, or Instagram without manually sourcing b-roll

### Template Information

| Property    | Value                                                              |
| ----------- | ------------------------------------------------------------------ |
| Template ID | `/base/v2/ai-avatar-broll/7c26a1cd-d5b3-42da-9c73-2413333873b3/v1` |
| Output Type | Video                                                              |
| Category    | AI Avatar                                                          |

### Parameters

| Parameter      | Type  | Required | Default | Description                                |
| -------------- | ----- | -------- | ------- | ------------------------------------------ |
| avatarVideoUrl | video | Yes      | -       | Video URL of avatar speaking the narration |

### How It Works

1. Upload a video of your avatar speaking (e.g., a talking head video)
2. The system analyzes the narration and automatically generates relevant B-roll footage
3. The B-roll is intelligently cut into the avatar video to create an engaging final product

### Example 1: Basic Usage

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

{
  "templateId": "/base/v2/ai-avatar-broll/7c26a1cd-d5b3-42da-9c73-2413333873b3/v1",
  "inputs": {
    "avatarVideoUrl": "https://example.com/my-avatar-speaking.mp4"
  },
  "render": true
}
```

### Example 2: With Hosted Video

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

{
  "templateId": "/base/v2/ai-avatar-broll/7c26a1cd-d5b3-42da-9c73-2413333873b3/v1",
  "inputs": {
    "avatarVideoUrl": "https://storage.example.com/videos/talking-head-video.mp4"
  },
  "render": true
}
```

### Tips for Best Results

1. Record a clear talking head video with good audio quality
2. Speak at a moderate pace to allow for B-roll insertion
3. Use natural pauses in your narration
4. Ensure consistent lighting and framing in your avatar video

### Related Templates

* AI Video with AI Voice
* AI Selfie Talking Video
* Combine Clips and Apply Basic Edits

### See Also

* Create Visual API Reference
* All Visual Templates


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.contouron.com/api/visual/ai-avatar-with-ai-generated-b-roll.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.