Rafiq API

v1.0.0OpenAPI 3.1.0

Async batch transcription. Authenticate with a Bearer rtk_ key.

Authentication

Pass your API key as a Bearer token on every request.

Authorization: Bearer rtk_…

Download the OpenAPI document

Endpoints

post/api/v1/upload-url

Request a pre-signed upload URL

Request bodyrequired

  • content_typestring

Responses

  • 200Upload URL and audio_token
  • 401Unauthorized
  • 429Rate limited
post/api/v1/transcripts

Create a transcription job

Request bodyrequired

  • audio_tokenstring
  • audio_urlstring <uri>
  • languagestring · one of: id, en · default: id
  • callback_urlstring <uri>

Responses

  • 201Job accepted (status: pending)
  • 400Invalid request
  • 401Unauthorized
  • 402Quota exceeded
  • 429Rate limited
get/api/v1/transcripts

List transcription jobs

Parameters

  • limitquery · integer
  • cursorquery · string

Responses

  • 200Paginated job list
get/api/v1/transcripts/{id}

Poll a transcription job

Parameters

  • idpath · string · required

Responses

  • 200Job with status and (when completed) transcript
  • 404Job not found
delete/api/v1/transcripts/{id}

Delete a transcription job and its audio

Parameters

  • idpath · string · required

Responses

  • 200Deleted
  • 404Job not found
get/api/v1/languages

List supported transcription languages

Responses

  • 200Supported languages