Autentikasi API lokal
Localhost, berbagi LAN, dan hosting mandiri jarak jauh untuk API desktop.
Pada localhost
Permintaan dari 127.0.0.1, ::1, atau localhost tidak memerlukan kredensial. SDK OpenAI tetap memerlukan api_key yang tidak kosong, jadi gunakan nilai apa pun seperti local.
Pada server jarak jauh atau bersama
Tetapkan OMNIVOICE_API_KEY pada mesin yang menjalankan VoiceStudio dan kirim sebagai token Bearer. Gunakan TLS atau Tailscale: HTTP biasa mengekspos kunci.
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 3900Untuk berbagi cepat, tersedia juga PIN sementara enam digit untuk HTTP non-loopback:
X-VoiceStudio-Pin: 123456PIN tidak mencakup WebSockets atau rute admin. Dikte dan administrasi jarak jauh memerlukan kunci API. /system/* dan /api/settings/* lebih ketat daripada rute ucapan, dan pengecualian jaringan tepercaya tidak pernah memberikan akses admin.
Jangan masukkan kunci ke URL
Kredensial dalam query string tersimpan di riwayat dan log proxy. Gunakan Authorization: Bearer … jika klien memungkinkan.
VoiceStudio Cloud
Tidak ada kredensial Cloud yang diterbitkan dan tidak ada server produksi yang diumumkan selama API terkelola belum dirilis. Lihat pratinjau Cloud.