مصادقة واجهة API المحلية
استخدام localhost والمشاركة عبر LAN والاستضافة الذاتية عن بُعد لواجهة سطح المكتب.
على localhost
لا تحتاج الطلبات من 127.0.0.1 أو ::1 أو localhost إلى بيانات اعتماد. لكن حزم OpenAI SDK تتطلب api_key غير فارغ، لذا استخدم أي قيمة مثل local.
على خادم بعيد أو مشترك
اضبط OMNIVOICE_API_KEY على الجهاز الذي يشغّل VoiceStudio وأرسله كرمز Bearer. استخدم TLS أو Tailscale: يكشف HTTP غير المشفّر المفتاح.
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 3900للمشاركة السريعة، يتوفر أيضًا رمز PIN مؤقت من ستة أرقام لاتصالات HTTP غير المحلية:
X-VoiceStudio-Pin: 123456لا يغطي رمز PIN اتصالات WebSockets أو المسارات الإدارية. يتطلب الإملاء والإدارة عن بُعد مفتاح API. مسارا /system/* و/api/settings/* أكثر صرامة من مسارات الكلام، ولا يمنح استثناء الشبكة الموثوقة صلاحية الإدارة مطلقًا.
لا تضع المفاتيح في عناوين URL
تظهر بيانات الاعتماد في سلسلة الاستعلام في السجل وسجلات الوكيل. استخدم Authorization: Bearer … عندما يسمح العميل بذلك.
VoiceStudio Cloud
ما دامت الواجهة المستضافة غير مُصدرة، لا تُصدر بيانات اعتماد Cloud ولا يُعلن عن خادم إنتاج. راجع معاينة Cloud.