Skip to content
TypeWhisper
DE
All platform editions

Platform edition

Cloudflare ASR

Cloudflare ASR for macOS

Bundled

OpenAI-compatible transcription behind a Cloudflare Tunnel with an Access service token.

Version
1.0.6
Plugin ID
com.typewhisper.cloudflare-asr
Requirements
TypeWhisper 1.5.0 or newer · macOS 14.0 or newer
macOS Source Code Release 1.0.6

Inside this edition

Cloudflare ASR macOS settings

Features in this edition

  • Cloud speech-to-text processing
  • Support for custom endpoints or proxies
  • Cloudflare Access authentication with a service token
  • Selection or refresh of available models

Settings in this edition

  • Set the server URL for the OpenAI-compatible endpoint
  • Store the CF-Access-Client-ID and CF-Access-Client-Secret
  • Optionally store a bearer token for the service behind the tunnel
  • Choose the transcription model in add-on or provider settings

Platform differences

On macOS, Cloudflare ASR connects to your OpenAI-compatible transcription backend through a Cloudflare Tunnel. On Windows, it calls Cloudflare Workers AI directly using your account ID and API token.

Setup on macOS: Cloudflare Tunnel

  1. Deploy an OpenAI-compatible transcription backend behind a Cloudflare Tunnel.
  2. If the service is protected by Cloudflare Access, create a service token for it.
  3. Open Settings > Integrations, find Cloudflare ASR, and open its configuration.
  4. Enter the backend’s base URL. TypeWhisper appends /v1/models for model discovery and /v1/audio/transcriptions for transcription, so do not enter the full transcription endpoint.
  5. For an Access-protected service, enter CF-Access-Client-Id and CF-Access-Client-Secret.
  6. Refresh the backend’s models and select one, or enter the model name manually when discovery is unavailable.
  7. Select Cloudflare ASR as the transcription engine in Settings or a profile.

Audio is sent to the backend you operate through Cloudflare. Its model and processing behavior depend on that backend.

Setup on Windows: Workers AI

  1. Obtain your Cloudflare Account ID and create an API Token authorized to use Workers AI for that account.
  2. Open Settings > Integrations, find Cloudflare ASR, and open its configuration.
  3. Enter Account ID and API Token, then save the configuration.
  4. Select Cloudflare ASR as the transcription engine and use Whisper (Cloudflare).

The Windows plugin constructs https://api.cloudflare.com/client/v4/accounts/{account-id}/ai/run/@cf/openai/whisper itself and authenticates with the API token. It uses the fixed Workers AI Whisper model; no custom endpoint, Tunnel, or Access service token is needed. Audio is sent to Cloudflare Workers AI.