Files

Store waveform peaks for an audio or video file

Safe to repeat. A body with more buckets than the stored waveform replaces it; any other leaves it as it is (stored: false). buckets is at most 100 per second of the file's probed duration (at least 256, at most 60000). An all-zero waveform is refused.

put/v1/files/{uuid}/waveform

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/files/{uuid}/waveform
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://contentmaschine.ai/api/oauth/authorize, token URL https://contentmaschine.ai/api/oauth/token)

Path parameters

uuidstring uuid required

The file uuid of a video or audio file in your library.

Request body

formatstring required

Must be "i8mm".

versioninteger

Optional; 1.

bucketsinteger required

Number of (min, max) pairs.

peaksstring required

Base64 of 2 x buckets signed bytes, each -127..127.

Response

The waveform now on file.

successboolean
timestampstring date-time

Example response

{
  "success": true
}

Changes

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