In the request body you can say whether the video needs to be in a collection (this needs to be an existing collection) and/or if you want us to fetch an existing video from a certain URL using the input_url (direct play is not supported the video will be available once we have processed the input)

Request (optional request body)

{
  "collection": "ubg50fRgMoWlCUU",
  "input_url": "readable_path_to_your_file"
}

Response

{
  "created": 1643723737, // when this video embed was created
  "duration": null, // duration of the video
  "id": "ubg50apemJaHEYZ", // the ID if you want to store it for your user and possibly webhooks
  "last_upload": null, // when a video has been uploaded
  "name": null, // name of the file or chosen name
  "object": "video", // the type of object you're looking at
  "poster_image": null, // uploaded poster or first frame of video when uploaded
  "size": null, // size of the video
  "renditions": [],
  "subtitles": []
}

Note: when you are over your accounts limit, the API will not warn you for potential extra costs.