Episodes

Start an episode

With source_url, Slice copies the file in from that https link (an RSS enclosure, a storage link). Without it, the answer carries a PUT upload url: upload the video, then POST /episodes/{id}/uploaded. Transcription and the clip search then start on their own. Video or audio: an audio file (MP3, M4A, AAC, WAV, OGG, Opus, FLAC) becomes an audio episode whose clips are drawn with an audio template.

post/episodes

Request

  • Base URL: https://tryslicemedia.com/api/v1
  • URL: https://tryslicemedia.com/api/v1/episodes
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Any unique string up to 255 characters, such as a UUID. A repeat with the same key and body within 24 hours gets the first answer and starts nothing new.

Request body

source_urlstring uri

A direct https link to the video or audio file, such as an RSS enclosure. Not a YouTube or other page.

file_namestring

For an upload: the file name, used for its type (.mp4, .mov, .m4v, .webm, .mkv, .avi, .mp3, .m4a, .aac, .wav, .ogg, .opus, .flac).

namestring
content_type'podcast' | 'stream' | 'other'
target_secondsinteger

How long each clip should be. Leave out for 30 to 150 seconds.

Response

Accepted

episode_idstring
namestring
status'waiting_for_upload' | 'uploading' | 'transcribing' | 'finding_clips' | 'ready' | 'failed'
livemodeboolean
upload_page_urlstring

The same upload as a page a person can open.

messagestring

Changes

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