Authentification de l’API locale
Localhost, partage sur le réseau local et auto-hébergement distant de l’API de bureau.
Sur localhost
Les requêtes depuis 127.0.0.1, ::1 ou localhost ne nécessitent pas d’identifiant. Les SDK OpenAI exigent tout de même un api_key non vide : utilisez une valeur quelconque, comme local.
Sur un serveur distant ou partagé
Définissez OMNIVOICE_API_KEY sur la machine exécutant VoiceStudio et envoyez-la comme jeton Bearer. Utilisez TLS ou Tailscale : HTTP non chiffré expose la clé.
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 3900Pour un partage rapide, un PIN temporaire à six chiffres est aussi disponible pour HTTP hors loopback :
X-VoiceStudio-Pin: 123456Le PIN ne couvre ni les WebSockets ni les routes administrateur. La dictée et l’administration à distance nécessitent la clé API. /system/* et /api/settings/* sont plus stricts que les routes vocales, et une exemption de réseau de confiance ne donne jamais accès à l’administration.
Ne mettez pas de clés dans les URL
Les identifiants dans la chaîne de requête se retrouvent dans l’historique et les journaux de proxy. Utilisez Authorization: Bearer … lorsque le client le permet.
VoiceStudio Cloud
Aucun identifiant Cloud n’est émis et aucun serveur de production n’est annoncé tant que l’API hébergée n’est pas publiée. Consultez l’aperçu Cloud.