---
updatedAt: 2025-06-18T06:24:45.000Z
agentTools:
  projectIndex: https://api.encoding.com/llms.txt
---

# Blank Frames Insertion

Add Blank-Frames source blocks to insert blank sequences between source parts.

```xml
<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> {/* required */}
    <userkey>[UserKey]</userkey> {/* required */}
    <action>AddMedia</action> {/* required */}
    <source>[SourceFile1]</source> {/* required */}
    <source>
        <color>[Color]</color> {/* required */}
        <duration>[InsertionDuration]</duration> {/* required */}
    </source>
    <source>[SourceFile2]</source>
    <source>
        <color>[Color]</color> {/* required */}
        <duration>[InsertionDuration]</duration> {/* required */}
    </source>
    <source>[SourceFile3]</source>
    <format> {/* required */}
        <output>[OutputFormat]</output> {/* required */}
        {/* format params */}
    </format>
</query>
```
```json
{
    "query": {
        "userid": "[UserID]", // required
        "userkey": "[UserKey]", // required
        "action": "AddMedia", // required
        "source": [ // required
            "[SourceFile1]", 
            {
                "color": "[Color]", // required
                "duration": "[Duration]" // required
            },
            "[SourceFile2]", 
            {
                "color": "[Color]", // required
                "duration": "[Duration]" // required
            },
            "[SourceFile3]" 
        ],
        "format": { // required
            "output": "[OutputFormat]" // required
            // format params
        }
    }
}
```

| Parameter    | Description                 | Allowed Values                                                                                                  | Default Values            |
| :----------- | :-------------------------- | :-------------------------------------------------------------------------------------------------------------- | :------------------------ |
| **color**    | Video Insertion solid color | Color in hex format                                                                                             | *none*, effectively black |
| **duration** | Sequence duration           | Valid Timecode in format:<br/>**HH:mm:ss:SS** - non-dropframe timecode<br/>**HH:mm:ss;SS** - dropframe timecode | *none*                    |

> 🚧 Note
>
> Blank frame insertion is currently limited in support to single-bitrate output formats (e.g. mp4, mpegts, etc.)
>
> Blank frame insertion is not presently compatible with split-screen transforms.

```
```