Create clips from existing media

The clipping feature in FastPix allows users to create clips from existing video files. This functionality serves various purposes, such as highlighting key moments, improving engagement and shareability, repurposing content for different platforms, and enhancing accessibility by providing shorter, focused viewing experiences.

Clips can be commonly used for promotional content, social media snippets, educational segments, and monetization through ads. Additionally, they help improve SEO by targeting specific keywords and increasing discoverability. By extracting concise, relevant parts from existing video files, you can maximize the impact and reach of your content.

Requirements

To successfully create a clip, ensure the following:

• The user must prepend the prefix fp_mediaId:// to the existing media ID in the payload's url parameter for clipping to work.

• The user can specify the startTime and endTime for the clip. If these values are not specified, the default will be the duration of the existing media ID.

• Clipping is supported only for existing media, and both the existing media and the clipping media must be in the same workspace.

How to create clips

To create clips, follow these steps:

• Clipping parameters: The clipping feature requires the existing media ID as the input URL for type "video". Ensure that both the existing media and the clipping media are in the same workspace.

• Payload structure: Construct your request body as follows:
  
  

{ 
  "inputs": [ 
    { 
      "type": "video", 
      "url": "fp_mediaId://0dde8722-278b-49e2-b0c8-52b57aaf2843", 
      "startTime": 0, 
      "endTime": 60 
    } 
  ], 
  "metadata": 
  { 
    "key1": "value1" 
  }, 
  "accessPolicy":"public", 
  "maxResolution":"1080p" 
} 

• Response handling: Upon successful creation, FastPix will return a response containing a new media ID and playback ID for the clip, which can be used for further operations.

Response body example

Here’s an example of the response body you can expect:

{ 
  "success": true, 
  "data": { 
    "id": "6a205f8b-ef52-4c4a-8fe8-33d4564454eb", 
    "trial": false, 
    "status": "created", 
    "createdAt": "2024-09-26T06:04:17.460453Z", 
    "updatedAt": "2024-09-26T06:04:17.460459Z", 
    "playbackIds": [ 
      { 
        "id": "87d9774a-96f0-4254-8326-77aafb065731", 
        "accessPolicy": "public" 
      } 
    ], 
    "metadata": { 
      "key1": "value1" 
    }, 
    "maxResolution": "1080p" 
  } 
} 

PLEASE NOTE
You can create an unlimited number of clips single source media ID. However, each clip is treated as a new media entity and is considered an on-demand video.This means that on-demand video pricing applies, which includes costs associated with encoding, storage, and delivery usage.