Audio

Transcribe an audio file you own (async)

Starts an asynchronous transcription of audio (or a video's sound track) already stored in your library. Upload it first with POST /v1/uploads (up to 2 GB) or POST /v1/files/upload (up to 48 MB) and pass the file_uuid it returns.

TWO DIFFERENT SCOPES ARE INVOLVED, and this is deliberate (D-15-07). Submitting needs audio:write. READING THE RESULT NEEDS text:read, because a transcript is text: both GET /v1/transcriptions/{uuid} and GET /v1/jobs/{id} classify this work into the text container.

A token holding only audio:write can start this job, be charged for it, and then never be able to read the transcript - the status poll and the transcript read both answer 404. Mint a token holding audio:write AND text:read for a complete workflow. The 202 body repeats this warning.

post/v1/audio/transcribe

Request

  • Base URL: https://contentmaschine.ai/api
  • URL: https://contentmaschine.ai/api/v1/audio/transcribe
  • 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)

Request body

file_uuidstring uuid required

An audio or video file you own.

languagestring

Optional language hint, e.g. "de" or "en-US", or "auto" to detect it.

diarizeboolean

Speaker separation. Must be a real boolean. Default false.

refinement_type'raw' | 'refined' | 'summary' | 'conclusions' | 'devils_advocate' | 'action_points'

What to produce beyond the raw transcript.

source_file_uuidstring uuid

The library file this transcript belongs to when file_uuid is audio taken from it (e.g. a video's sound track). Defaults to file_uuid.

reuseboolean

true: when the source file already has a finished transcript with timing (or one still running), answer 200 with it and charge nothing.

Response

reuse: true and the source file already has a transcript; nothing was charged.

successboolean
timestampstring date-time

Example response

{
  "success": true
}

Changes

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