Sign in

v1

latestOpenAPI 3.0.2Terms of Use2026-08-061441681.6 MB
clipping

Create a clip

This operation creates (or replaces) a video object in Wowza Video by clipping a video or live stream or, clipping and stitching together videos or live streams.

Create a clip

To create a clip off of an existing video or live stream, send the id of the video or live stream you want to clip along with the asset_type, mode, start, and stop parameters.

Create clips and stitch the clips

To create multiple clips and stitch the clips together as one clip, send the id of the videos or live streams you want to clip along with the asset_type, mode, start, and stop parameters.

Create a clip and replace the original video

To create a clip and replace the original video with the clip, send the replace_video_id parameter where replace_video_id is the video id of the video to be replaced, along with the asset_type, mode, start, and stop parameters.

Note: The replace option works only with videos and not live streams. The replace_video_id is specifically a video ID and not a live stream ID.

Caution! Once you replace the original video with the clip, you will no longer be able to retrieve the original video.

post/clipping

Request body

Example request

{
  "clipping": {
    "clips": [
      {
        "id": "test",
        "asset_type": "VOD",
        "start": "00:01:20:00",
        "stop": "00:05:25:00"
      }
    ],
    "mode": "PRECISE",
    "name": "My video",
    "description": "A new video for my business.",
    "unpublished_at": "2025-01-01T12:33:22Z",
    "ad_keywords": "special_ads"
  }
}

Response

Success

Example response

{
  "video": {
    "id": "73a0c613-8972-14cd-9d0c-3c993bddb388",
    "name": "My video",
    "description": "A new video for my business.",
    "unpublished_at": "2020-01-01T12:33:22Z",
    "published_at": "2020-01-01T12:33:22Z",
    "tags": [
      "foo",
      "bar"
    ],
    "ad_keywords": "special_ads",
    "created_at": "2024-05-15T12:33:22Z",
    "updated_at": "2024-05-16T12:33:22Z",
    "state": "PROCESSING",
    "images": [
      {
        "url": "https://example.com/image.jpg"
      }
    ],
    "encodings": [
      {
        "audio_bitrate_in_kbps": 2300,
        "audio_channel": 2,
        "audio_codec": "aac",
        "audio_sample_rate": 44100,
        "height": 1080,
        "width": 1920,
        "video_file_url": "https://flowplayer.com/video.mp4",
        "video_container": "mp4",
        "video_codec": "h264",
        "total_bitrate_in_kbps": 1023,
        "size_in_bytes": 8325555
      }
    ]
  }
}