transcribe-provider-openai-compat

Enterprise Part of the commercial Kumiko Enterprise offering — not in the open framework.

Registers an OpenAI-compatible /v1/audio/transcriptions endpoint as the "openai-compat" transcription provider in ai-foundation. Works with OpenAI, Groq, local faster-whisper-server, and any other server that speaks the same audio API — point the per-tenant endpoint config-key at your server and set the model name; the API key is optional for local deployments. Set the ai-foundation transcribeProvider config-key to "openai-compat" to activate it.

How it fits

What this feature needs to run (Requires, top) and the write commands it provides (Provides, bottom).

flowchart TB
  n_transcribe_provider_openai_compat["transcribe-provider-openai-compat"]
  subgraph how_reqs["Requires"]
    n_config["config"]
    n_secrets["secrets"]
    n_ai_foundation["ai-foundation"]
  end
  n_config --> n_transcribe_provider_openai_compat
  n_secrets --> n_transcribe_provider_openai_compat
  n_ai_foundation --> n_transcribe_provider_openai_compat

Dependencies

• Requires: config, secrets, ai-foundation
• Activation: always on (not toggleable)

Configuration

Per-tenant config keys, set via the tenant-admin UI or a seed. 🔒 = encrypted at rest.

Key	Type	Default	Scope	Who can write	Who can read
endpoint	text	""	tenant	TenantAdmin, SystemAdmin	TenantAdmin, SystemAdmin
model	text	""	tenant	TenantAdmin, SystemAdmin	all

Secrets

Secret	Scope	Hint
transcribe-provider-openai-compat:secret:transcribe-openai-compat-api-key	tenant	Optional. Required for OpenAI/Groq, leave empty for a local faster-whisper-server.

Extensions & cross-feature APIs

• Registers extension: transcribeProvider → openai-compat