Autenticação da API local
Localhost, compartilhamento em rede local e hospedagem remota da API desktop.
No localhost
Solicitações de 127.0.0.1, ::1 ou localhost não precisam de credencial. Os SDKs da OpenAI ainda exigem um api_key não vazio; use qualquer valor, como local.
Em um servidor remoto ou compartilhado
Defina OMNIVOICE_API_KEY no computador que executa o VoiceStudio e envie-a como token Bearer. Use TLS ou Tailscale: HTTP sem proteção expõe a chave.
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 compartilhamento rápido, há também um PIN temporário de seis dígitos para HTTP fora de loopback:
X-VoiceStudio-Pin: 123456O PIN não cobre WebSockets nem rotas administrativas. Ditado e administração remotos precisam da chave de API. /system/* e /api/settings/* são mais restritos que rotas de fala, e uma exceção de rede confiável nunca concede acesso administrativo.
Não coloque chaves em URLs
Credenciais na query string ficam no histórico e nos logs de proxy. Use Authorization: Bearer … sempre que o cliente permitir.
VoiceStudio Cloud
Nenhuma credencial Cloud é emitida e nenhum servidor de produção é anunciado enquanto a API hospedada não for lançada. Veja a prévia Cloud.