Transcriptions

Start an upload

Returns the generated media_id plus a presigned PUT URL. Upload the raw bytes to upload_url with the same Content-Type you declared here, then call POST /transcriptions with the media_id to start the job.

Both video and audio files are accepted, so an audio-only podcast never has to be wrapped in a video container. The ceiling is the smaller of your plan's upload limit and the storage quota you still have free; FILE_TOO_LARGE reports the effective ceiling in max_size and STORAGE_LIMIT_EXCEEDED means the quota is full.

post/transcriptions/upload

Request

  • Base URL: https://api.cut.pro/api/v1
  • URL: https://api.cut.pro/api/v1/transcriptions/upload
  • Auth: API key in header X-Api-Key

Request body

file_namestring required

Original file name. The extension decides whether this is treated as audio or video.

file_sizenumber required

Size of the file in bytes.

content_typestring

MIME type. Defaults to audio/mpeg or video/mp4, and must match the bytes you PUT.

Response

Response for status 200

media_idstring required

Generated media ID. Pass it to POST /transcriptions.

kind'video' | 'audio' required
upload_urlstring required

Presigned PUT URL. Upload the raw bytes here.

expires_innumber required

Seconds until upload_url expires.

Changes

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