Skip to Content
Cut.ProDocs
Transcription

Transcribe a video from a link

Downloads a YouTube, TikTok, Instagram, Twitch or Kick video, adds it to your library and transcribes it, charged like POST /transcriptions by the video's length. Poll GET /transcriptions/{transcriptionId} until ready. 400 UNAVAILABLE when the link cannot be read (private, removed, unsupported site), 502 UNAVAILABLE when the download failed and can be tried again, 503 SERVICE_UNAVAILABLE when downloads are paused for a moment.

Authorization

apiKey
headerX-Api-Key<token>

Request Body

  1. body
url*string

Link to the video

Lengthlength <= 2048
speaker_labels?boolean

Identify who is speaking on each cue. Costs more. Default false.

source_language?string

Spoken language, e.g. pt. Omit to auto-detect.

Response Body

Response for status 202

application/json
  1. response
id*string

Transcription id; poll GET /transcriptions/{transcriptionId}

status*"processing"
Value in"processing"
credits_charged*number
POST
/transcriptions/import
Example Request
curl -X POST 'https://api.cut.pro/api/v1/transcriptions/import' \  -H 'Content-Type: application/json' \  -d '{  "url": "string"}'
Example Response
{  "id": "string",  "status": "processing",  "credits_charged": 0}