/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.

punctuatebooleanKeep punctuation and casing. Set to false for bare words. Defaults to true.

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 мілісекунд."
  },
  "charged_sec": 13,
  "charged_from_quota_sec": 13,
  "charged_from_credits_sec": 0,
  "quota_remaining_sec": 59987,
  "credits_remaining_sec": 58620
}

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 →