REST API reference

Explore all seven Fast Transcriber transcription workflow operations, shared conventions, and response envelopes.

livehttps://fast-transcriber.com/api/v1

Base URL

https://fast-transcriber.com/api/v1

All protected operations use HTTPS and the same bearer authentication scheme.

Conventions

JSON envelopes

Success uses data; immediate failure uses error.code and error.message.

Async processing

Job creation returns 202 and a Location header instead of holding the request open.

Tenant scoped

Jobs and uploaded objects are accessible only through the API account that owns them.

Stable identifiers

Methods, paths, fields, and machine-readable error codes remain in English.

Operations

Each operation has a dedicated page with fields, payloads, responses, errors, and implementation notes.

GET/api/v1Discover the current API version and documentation URLs.POST/api/v1/uploadsCreate a presigned single-part or multipart target for an audio or video file.POST/api/v1/uploads/multipartCommit all uploaded parts before creating the transcription job.DELETE/api/v1/uploads/multipartDiscard an incomplete multipart transfer.GET/api/v1/transcriptionsReturn the authenticated account's most recent transcription jobs.POST/api/v1/transcriptionsQueue one public URL or previously uploaded file for asynchronous transcription.GET/api/v1/transcriptions/{id}Retrieve job status and the completed transcript result.

Source models

Create-transcription accepts exactly one of these shapes:

{
  "source_url": "https://cdn.example.com/interview.mp3",
  "speaker_diarization": false
}

{
  "upload": {
    "filename": "interview.mp3",
    "key": "transcriptions/user_…/interview.mp3",
    "size": 1234567,
    "storage": "r2",
    "content_type": "audio/mpeg"
  }
}

Job status

processingThe worker is resolving or transcribing media.completedText and available segments are ready.orfailedProcessing stopped; inspect data.error.