Uploads

Send your own file

For footage that is private, geo-blocked, or never was on a platform at all. Returns an upl_… id that is a valid url for every later call about the same video.

Editing and delivery containers work, not just web video: mp4, mov (including ProRes), mkv, webm, avi, mxf (XAVC, XDCAM, AVC-Intra, DNxHD), gxf, lxf, ts and dv. Camera raw — .r3d, .braw, .ari, .crm — needs the manufacturer's own decoder and is refused by name, with the export to make instead.

When the file carries SMPTE timecode, every tile is stamped with it alongside the elapsed time, and video.start_timecode reports where the source's own clock starts.

post/v1/uploads

Request

  • Base URL: https://api.tryplayhead.com
  • URL: https://api.tryplayhead.com/v1/uploads
  • Auth: HTTP bearer

Response

The upload id and what was probed from the file.

upload_idstring

Pass this as upload_id on a later video call.

size_bytesinteger

What is stored.

received_bytesinteger

What was sent.

credits_chargednumber

Zero for a metadata read.

Changes

No recorded changes to this operation across all 1 revision of this API.