Skip to main content
FluidVoice exposes a local HTTP server on your Mac that you can call from shell scripts, Raycast extensions, Automator actions, or any other tool that can make HTTP requests. The server listens exclusively on the loopback interface, so only processes running on your Mac can reach it — no authentication token is required, and no traffic ever leaves your machine.

​
Base URL and default port

The default port is 47733. If you change the port in settings, replace 47733 in every example with your chosen port.

​
Request and response format

All endpoints accept and return JSON unless otherwise noted. Every response sets Content-Type: application/json; charset=utf-8. Dates are formatted as ISO 8601 strings (e.g. 2025-01-15T09:41:00Z). The maximum request body size is 25 MB — requests larger than this are rejected with HTTP 413.

​
Quick start

Check that FluidVoice is running and get the current app version:

​
Security model

The server only accepts connections from 127.0.0.1, ::1, or localhost. Any connection from a non-loopback address is dropped immediately. See Security for details.

​
Available endpoints

​
Common use cases

  • Shell scripts — pipe audio files through FluidVoice from the terminal or a cron job.
  • Raycast extensions — trigger transcription or retrieve history without opening the app UI.
  • Automator actions — chain FluidVoice transcription into macOS workflows.
  • Third-party integrations — connect any tool that can send HTTP requests to a local server.
  • Text pipelines — transcribe audio in one step and call /v1/postprocess separately to polish the output on demand.