Speech To Text (Hear)

​

Transcribe one file

pip install pyai-sdk
# or
npm install @pyai/sdk

curl https://api.pyai.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $PYAI_API_KEY" \
  -F file=@audio.wav \
  -F model=pyai-hear \
  -F language=en

import os
from pyai import PyAI

pyai = PyAI(api_key=os.environ["PYAI_API_KEY"])
result = pyai.audio.transcriptions.create(
    file=open("audio.wav", "rb"),
    model="pyai-hear",
    language="en",
)
print(result["text"])

import PyAI from "@pyai/sdk";
import { readFile } from "node:fs/promises";

const pyai = new PyAI({ apiKey: process.env.PYAI_API_KEY! });
const result = await pyai.audio.transcriptions.create({
  file: new Blob([await readFile("audio.wav")]),
  filename: "audio.wav",
  model: "pyai-hear",
  language: "en",
});
console.log(result.text);

{ "text": "Your appointment is confirmed for Thursday at two." }

​

Stream live speech

wss://api.pyai.com/v1/audio/transcriptions/stream
  ?protocol=pyai-hear-v1
  &language=auto
  &sample_rate=16000
  &encoding=pcm16
  &interim_results=true

​

Process a finished recording

• Word- or segment-level timestamps.
• Stereo channel separation or mono diarization. If diarization cannot be produced for a recording, the job completes with mode transcript and no speaker labels — check the mode field.
• SRT or VTT output.
• A result that survives the submission request.
• Polling or a signed completion webhook.
• Idempotent URL-based submission.

​

Format final transcripts

• numerals: digits or spoken-number form.
• smart_format: sentence capitalization and punctuation.
• dictation: spoken punctuation commands.
• drop_fillers: optional filled-pause removal.
• vocabulary: request-level or explicitly enabled stored terms for known vocabulary.

​

Phone audio

​

OpenAI compatibility