Create Highlight Clip
create_clipCreate highlight clips from media files by specifying time ranges. Stitch segments from multiple files into one clip up to 30 minutes.
Instructions
Create a highlight clip from one or more media files by specifying time ranges. Clips are processed asynchronously (states: queued, processing, completed, failed) — use get_clips to check status. Maximum total clip duration is 30 minutes. Use multiple timeRanges to stitch segments from different media files together.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>",
"mediaType": "<mediaType>",
"timeRanges": "<timeRanges>"
},
"name": "create_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Tags for the clip | |
| title | Yes | Title for the clip | |
| mediaType | Yes | Output media type | |
| timeRanges | Yes | Array of time ranges to include in the clip. Each specifies a source media and start/end times. | |
| description | No | Description of the clip | |
| mergeStrategy | No | How to merge multiple segments (default: CONCATENATE) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Response payload from the Speak AI API |