Clip videos given a start and end time

POST

https://api.cloudflare.com/client/v4/accounts/{account_identifier}/stream/clip

Last modified:2022-12-16 13:48:35

Clips a video based on the specified start and end times provided in seconds.

Request

Path Params

Body Params application/json

Example

{
    "allowedOrigins": [
        "example.com"
    ],
    "creator": "creator-id_abcde12345",
    "maxDurationSeconds": 1,
    "thumbnailTimestampPct": 0.529241,
    "watermark": {
        "uid": "ea95132c15732412d22c1476fa83f27a"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts//stream/clip' \
--header 'Content-Type: application/json' \
--data-raw '{
    "allowedOrigins": [
        "example.com"
    ],
    "creator": "creator-id_abcde12345",
    "maxDurationSeconds": 1,
    "thumbnailTimestampPct": 0.529241,
    "watermark": {
        "uid": "ea95132c15732412d22c1476fa83f27a"
    }
}'

Responses

🟢200Clip videos given a start and end time response

application/json

Body

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "0": null,
        "allowedOrigins": [
            "example.com"
        ],
        "clippedFromVideoUID": "023e105f4ecef8ad9ca31a8372d0c353",
        "created": "2014-01-02T02:20:00Z",
        "creator": "creator-id_abcde12345",
        "endTimeSeconds": 0,
        "maxDurationSeconds": 1,
        "meta": {
            "name": "example_filename.mp4"
        },
        "modified": "2014-01-02T02:20:00Z",
        "playback": {
            "dash": "https://customer-m033z5x00ks6nunl.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/manifest/video.mpd",
            "hls": "https://customer-m033z5x00ks6nunl.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/manifest/video.m3u8"
        },
        "preview": "https://customer-m033z5x00ks6nunl.cloudflarestream.com/ea95132c15732412d22c1476fa83f27a/watch",
        "requireSignedURLs": true,
        "startTimeSeconds": 0,
        "status": "inprogress",
        "thumbnailTimestampPct": 0.529241,
        "watermark": {
            "uid": "ea95132c15732412d22c1476fa83f27a"
        }
    },
    "success": true,
    "result_info": {
        "count": 1,
        "page": 1,
        "per_page": 20,
        "total_count": 2000
    }
}

🟢200Clip videos given a start and end time response failure

Modified at 2022-12-16 13:48:35

Upload captions or subtitles

List videos