Autenticación de la API local
Localhost, uso compartido en LAN y autoalojamiento remoto de la API de escritorio.
En localhost
Las solicitudes desde 127.0.0.1, ::1 o localhost no necesitan credenciales. Los SDK de OpenAI exigen un api_key no vacío; usa cualquier valor, como local.
En un servidor remoto o compartido
Configura OMNIVOICE_API_KEY en el equipo que ejecuta VoiceStudio y envíala como token Bearer. Usa TLS o Tailscale: HTTP sin cifrar expone la clave.
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 3900Para compartir rápidamente, también hay un PIN temporal de seis dígitos para HTTP fuera de loopback:
X-VoiceStudio-Pin: 123456El PIN no cubre WebSockets ni rutas de administrador. El dictado y la administración remotos requieren la clave API. /system/* y /api/settings/* son más estrictas que las rutas de voz, y una exención de red confiable nunca concede acceso de administrador.
No incluyas claves en las URL
Las credenciales en la cadena de consulta quedan en el historial y los registros del proxy. Usa Authorization: Bearer … siempre que el cliente lo permita.
VoiceStudio Cloud
No se emiten credenciales Cloud ni se anuncia ningún servidor de producción mientras la API alojada no se haya publicado. Consulta la vista previa de Cloud.