Release NotesUser InterfaceSystem Status
API Reference

Video Clipping

Create smaller clips of a larger source video.

Multiple clips

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[OutputFormat]</output> <!-- required-->
        <trim>
            <start>[StartTimecode]</start>
            <end>[EndTimecode]</end>
        </trim>
        <trim>
            <!-- trim parameters -->
        </trim>
        <!-- Multiple trim blocks may be included -->
        <!-- format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[OutputFormat]", // required
            "trim": [
                {
                    "start": "[StartTimecode]",
                    "end": "[EndTimecode]"
                },
                {
                    // trim parameters
                }
                // Multiple trim blocks may be included
            ]
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
startSpecify where the video clip should start.Non-negative float or timecodenone
endSpecify where the video clip should end.Non-negative float or timecodenone

Single clip

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format>
        <output>[OutputFormat]</output> <!-- required-->
        <start>[StartTimecode]</start>
        <finish>[FinishTimecode]</finish>
        <duration>[Duration]</duration>
        <!-- Format params -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "[Action]", // required
        "source": "[SourceFile]", // required
        "format": {
            "output": "[OutputFormat]", // required
            "start": "[StartTimecode]",
            "finish": "[FinishTimecode]",
            "duration": "[Duration]"
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
startSpecify where the video clip should start.Non-negative float or timecodenone
finishSpecify where the video clip should end.Non-negative float or timecodenone
durationSpecify the duration of the video clip.Positive integernone

👍

For start and finish parameters

Timecode should have following format HH:MM:SS[:;]FF, where:

  • HH – hours
  • MM – minutes
  • SS – seconds
  • [:;] – : – non drop-frame, ; – drop-frame;
  • FF – frames

🚧

Note

If <finish /> and <duration /> parameters are specified simultaneously, the <duration /> parameter will be ignored.