/api/v1/transcribe

Submit an audio file for transcription, optionally translated into a target language.Authentication required

Request

Send a multipart/form-data body with the audio file and any optional fields. Returns a single JSON object once the transcription is complete.

HTTP

POST https://api.varmir.com/api/v1/transcribe
Authorization: Bearer <YOUR_API_KEY>
Content-Type: multipart/form-data

# fields
[email protected]
translate_to=uk

Parameters

FieldTypeDescription

audiofile (multipart)PCM WAV, FLAC, MP3 or OGG. Up to 100 MB.

translate_tostringOptional ISO-639 code. Skip to return the transcript only.

languagestringOptional source language hint. Defaults to auto-detect.

punctuatebooleanRestore punctuation and casing. Defaults to true.

diarizebooleanTag words with speaker IDs. Currently English only.

Response

Returns the final transcript, the optional translation, and updated credit balance.

{
  "id": "tr_8f3a2c",
  "duration_sec": 12.4,
  "language": "en",
  "text": "Welcome to the Varmir demo. The pipeline runs in under 200 milliseconds.",
  "translation": {
    "language": "uk",
    "text": "Ласкаво просимо до демо Varmir. Конвеєр працює менш ніж за 200 мілісекунд."
  },
  "credits_used": 5,
  "credits_remaining": 977
}

Code examples

curl https://api.varmir.com/api/v1/transcribe \
  -H "Authorization: Bearer mstk_your_key" \
  -F "[email protected]" \
  -F "translate_to=uk"

Previous← GET /api/v1/me NextWS /api/v1/stream →