transcribe

Transcribe an audio file to text.

Transcribe an audio file to text. POST { url, language?, diarize? } — the audio is fetched from your URL (wav, mp3, m4a/aac, ogg/opus, flac, webm; up to 15 MB and 15 minutes per call — split longer recordings and call once per segment). Returns the full punctuated transcript, overall confidence, audio duration, detected or specified language (BCP-47, e.g. "en", "es"), word-level timestamps with confidences, and — with diarize=true — speaker-segmented utterances (who said what, when). High-accuracy speech recognition for meeting notes, podcast processing, voicemail handling, and media monitoring. Billing: payment settles before this endpoint runs (paid upstream), so an error after settlement IS charged — the error response then carries the payment receipt (PAYMENT-RESPONSE) and X-2s-Charged: true. upto-scheme payments settle only after success.

post/api/transcribe/audio

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/transcribe/audio
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Request body

urlstring uri required

Public audio URL. Caps: 15 MB, 15 minutes.

languagestring

Two-letter ISO language code.

diarizeboolean

Diarize.

Response

(unresolved $ref)

Changes

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