Authentifizierung der lokalen API
Localhost, LAN-Freigabe und Remote-Selbsthosting für die Desktop-API.
Auf localhost
Anfragen von 127.0.0.1, ::1 oder localhost benötigen keine Zugangsdaten. OpenAI-SDKs verlangen dennoch einen nicht leeren api_key; verwende einen beliebigen Wert wie local.
Auf einem entfernten oder gemeinsam genutzten Server
Setze OMNIVOICE_API_KEY auf dem Rechner mit VoiceStudio und sende den Schlüssel als Bearer-Token. Verwende TLS oder Tailscale: unverschlüsseltes HTTP legt den Schlüssel offen.
export OMNIVOICE_API_KEY="$(python -c 'import secrets; print(secrets.token_urlsafe(24))')"
uv run uvicorn backend.main:app --host 0.0.0.0 --port 3900Für schnelles Teilen gibt es außerdem eine temporäre sechsstellige PIN für HTTP außerhalb von Loopback:
X-VoiceStudio-Pin: 123456Die PIN gilt nicht für WebSockets oder Admin-Routen. Ferndiktat und Fernverwaltung benötigen den API-Schlüssel. /system/* und /api/settings/* sind strenger als Sprachrouten; eine Ausnahme für vertrauenswürdige Netzwerke gewährt niemals Admin-Zugriff.
Keine Schlüssel in URLs
Zugangsdaten im Query-String landen im Verlauf und in Proxy-Protokollen. Verwende Authorization: Bearer …, wo immer der Client es erlaubt.
VoiceStudio Cloud
Solange die gehostete API nicht veröffentlicht ist, werden keine Cloud-Zugangsdaten ausgegeben und kein Produktionsserver angegeben. Siehe Cloud-Vorschau.