Yerel API kimlik doğrulaması
Masaüstü API’si için localhost, LAN paylaşımı ve uzaktan kendi kendine barındırma.
localhost üzerinde
127.0.0.1, ::1 veya localhost kaynaklı istekler kimlik bilgisi gerektirmez. OpenAI SDK’ları yine de boş olmayan bir api_key ister; local gibi herhangi bir değer kullanın.
Uzak veya paylaşılan sunucuda
VoiceStudio’nun çalıştığı makinede OMNIVOICE_API_KEY ayarlayın ve Bearer belirteci olarak gönderin. TLS veya Tailscale kullanın: düz HTTP anahtarı açığa çıkarır.
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 3900Hızlı paylaşım için loopback dışı HTTP üzerinde geçici altı haneli bir PIN de vardır:
X-VoiceStudio-Pin: 123456PIN, WebSocket’leri veya yönetici rotalarını kapsamaz. Uzaktan dikte ve yönetim API anahtarı gerektirir. /system/* ve /api/settings/* konuşma rotalarından daha katıdır; güvenilir ağ istisnası hiçbir zaman yönetici erişimi sağlamaz.
Anahtarları URL’lere koymayın
Sorgu dizisindeki kimlik bilgileri geçmişe ve proxy günlüklerine kaydedilir. İstemci izin verdiğinde Authorization: Bearer … kullanın.
VoiceStudio Cloud
Barındırılan API yayımlanmamışken Cloud kimlik bilgileri verilmez ve üretim sunucusu duyurulmaz. Cloud önizlemesine bakın.