在 localhost 上

来自 127.0.0.1、::1 或 localhost 的请求无需凭据。OpenAI SDK 仍要求非空的 api_key，因此可传入任意值，例如 local。

在远程或共享服务器上

在运行 VoiceStudio 的机器上设置 OMNIVOICE_API_KEY，并将其作为 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

为了快速共享，非回环 HTTP 还提供临时六位 PIN：

X-VoiceStudio-Pin: 123456

PIN 不适用于 WebSocket 或管理员路由。远程语音输入和远程管理需要 API 密钥。/system/* 和 /api/settings/* 比语音路由更严格，受信任网络豁免绝不会授予管理员权限。

不要将密钥放在 URL 中

查询字符串中的凭据会留在历史记录和代理日志中。客户端允许时请使用 Authorization: Bearer …。

托管 API 尚未发布期间，不会发放 Cloud 凭据，也不会公布生产服务器。请参阅 Cloud 预览。

来自 127.0.0.1、::1 或 localhost 的请求无需凭据。OpenAI SDK 仍要求非空的 api_key，因此可传入任意值，例如 local。

在运行 VoiceStudio 的机器上设置 OMNIVOICE_API_KEY，并将其作为 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

为了快速共享，非回环 HTTP 还提供临时六位 PIN：

X-VoiceStudio-Pin: 123456

不要将密钥放在 URL 中

查询字符串中的凭据会留在历史记录和代理日志中。客户端允许时请使用 Authorization: Bearer …。

托管 API 尚未发布期间，不会发放 Cloud 凭据，也不会公布生产服务器。请参阅 Cloud 预览。