POST
/
clip
curl --request POST \
  --url https://api.video.dev/v1/clip \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "start_time_ms": 123,
  "end_time_ms": 123,
  "from_media_id": "<string>"
}'
{
  "start_time_ms": 123,
  "end_time_ms": 123,
  "clip_id": "<string>",
  "duration_ms": 123,
  "source_media": {
    "status": "complete",
    "media_id": "<string>",
    "media_url": "https://storage.xyz/media.mp4",
    "media_info": {
      "type": "video",
      "duration_ms": 123,
      "fps": 123,
      "frame_count": 123,
      "width": 123,
      "height": 123,
      "channels": 123
    }
  }
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
use params.query to specify search query
​
start_time_ms
number
required

Start time (milliseconds) of clip in source media

​
end_time_ms
number
required

End time (milliseconds) of clip in source media

​
from_media_id
string

Source media to create clips from

Response

200
application/json
Clip workflow initiated successfully
​
start_time_ms
number
required

Start time (milliseconds) of clip in source media

​
end_time_ms
number
required

End time (milliseconds) of clip in source media

​
clip_id
string
required

Identifier for the clip

​
duration_ms
number
required

Duration of the clip in milliseconds

​
source_media
object
required

Source media to create clip from

Was this page helpful?