Experimental integration surface

Local HTTP API

HyperYap can expose a localhost-only transcription endpoint while the desktop app is open. It is intended for local tools that need a private speech-to-text engine.

Enable it

  1. Open HyperYap.
  2. Go to Settings, then System.
  3. Enable Local API.
  4. Use the configured localhost port. The default is 4800.

Endpoint

POST http://127.0.0.1:4800/api/transcribe

Send a multipart form field named audio containing a WAV file.

curl -X POST http://127.0.0.1:4800/api/transcribe \
  -F "audio=@recording.wav;type=audio/wav"

Response

{
  "text": "Hello everyone, here is the complete transcript..."
}

Errors return a JSON object with an error message.

Security model

  • The API listens on localhost.
  • CORS is not enabled.
  • Requests are processed sequentially through the local transcription engine.
  • Audio files must be WAV and no larger than the app limit.