POST /accounts/{account_id}/stream/clip
Clips a video based on the specified start and end times provided in seconds.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
String | Yes |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
maxDurationSeconds |
Integer | No |
The maximum duration in seconds for a video upload. Can be set for a video that is not yet uploaded to limit its duration. Uploads that exceed the specified duration will fail during processing. A value of |
endTimeSeconds |
Integer | Yes |
Specifies the end time for the video clip in seconds. |
clippedFromVideoUID |
String | Yes |
The unique video identifier (UID). |
startTimeSeconds |
Integer | Yes |
Specifies the start time for the video clip in seconds. |
allowedOrigins[] |
Array | No |
Lists the origins allowed to display the video. Enter allowed origin domains in an array and use |
requireSignedURLs |
Boolean | No |
Indicates whether the video can be a accessed using the UID. When set to Default value: false |
thumbnailTimestampPct |
Number | No |
The timestamp for a thumbnail image calculated as a percentage value of the video's duration. To convert from a second-wise timestamp to a percentage, divide the desired timestamp by the total duration of the video. If this value is not set, the default thumbnail image is taken from 0s of the video. Default value: 0 |
watermark |
Object | No | |
watermark.uid |
String | No |
The unique identifier for the watermark profile. |
creator |
String | No |
A user-defined identifier for the media creator. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.