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 |
|---|---|---|---|
input |
String | No |
A video's URL. Preferred over 'url'. |
url |
String | No |
A video's URL (legacy field, use 'input' instead). |
clippedFromVideoUID |
String | Yes |
The unique video identifier (UID). |
meta |
Object | No |
A user modifiable key-value store used to reference other systems of record for managing videos. |
allowedOrigins[] |
Array | No |
Lists the origins allowed to display the video. Enter allowed origin domains in an array and use |
creator |
String | No |
A user-defined identifier for the media creator. |
scheduledDeletion |
String | No |
Indicates the date and time at which the video will be deleted. Omit the field to indicate no change, or include with a |
name |
String | No |
A name for the video. |
endTimeSeconds |
Integer | Yes |
Specifies the end time for the video clip in seconds. |
startTimeSeconds |
Integer | Yes |
Specifies the start time for the video clip in seconds. |
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. |
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.