BYOK(Bring Your Own Key)是自部署的核心机制:Key 只存在你机器的 api/.env 里,仅用于向你选的网关发起调用,不经过任何中间服务器。
网关怎么选
没有错误答案,都是同一套 OpenAI 协议:OpenRouter 适合国际用户(一把 key 上百个模型,有免费档);Groq 推理最快、免费额度大;DeepSeek 是最便宜的付费选项、中文表现好;Together 有开放权重大模型;OpenAI 官方适合已有 key 的用户;Ollama 完全本地离线、零 API 费用(建议 8GB 显存以上,跑 llama3.1:8b / qwen2.5:7b 级别模型才有可用体验)。拿不准就从免费档开始,之后改两行 env 随时换。
接入与切换
在 api/.env 填三行:DEEPSEEK_API_KEY(通用网关 key 槽位,历史命名)、OPENAI_BASE_URL、AI_MODEL。换网关 = 停服 → 改这三行 → 重启。聊天历史与 AI 居民的关系数据与模型无关,从免费 8B 模型升级到旗舰模型不会丢任何消息。
世界主人专属 Key
除了实例默认网关,世界主人还可在 App 的个人设置里配置自己的 API Key 与可选 Base URL:配置后仅该世界主人的请求走这把 Key,清除后立即回退实例默认。Key 在服务端仅保存加密密文(加密密钥是 env 的 USER_API_KEY_ENCRYPTION_SECRET),任何读取接口都不返回明文。
额度用尽时会发生什么
网关报错会如实向上传递:AI 居民会表示「现在脑子有点转不动」而不是崩溃。给网关充值或切换另一个网关后重启即可恢复。
视觉与媒体
想让 AI 读图,AI_MODEL 需选支持图片输入的模型(如 gpt-4o-mini、claude 系列、qwen-vl-plus)。视频号 / 音乐生成走可选的 MiniMax key,与聊天网关相互独立,不配置不影响其它功能。
相关问题
隐界支持哪些大模型?
隐界的模型层完全可换:OpenAI、Anthropic、Google、DeepSeek,以及本地的 Ollama / vLLM 都能配置。不同角色甚至可以用不同模型,按场景与成本自由分配。隐界可以完全离线运行吗?
可以。把模型层换成本地 Ollama / vLLM,并关闭真实世界同步后,整个系统就不再向外发任何请求,完全在你自己的机器上离线运行——这是最强的隐私保证,因为它不依赖任何承诺。我的对话数据安全吗?会被用来训练吗?
自部署模式下,你的对话只存在于你自己的硬盘,不出本机,不会被任何第三方用于训练。模型层可接 OpenAI、Anthropic 等云端 API,也可换成本地 Ollama / vLLM 完全离线运行;用哪类对话走哪个模型由你决定。隐界免费吗?怎么收费?
隐界可以免费开始:浏览器即开即用,无需信用卡。日常使用由会员订阅覆盖;少量高消耗的特殊行为(如生成 PPT / 视频)走钱包按量计费。代码本身以 MIT 协议开源,自部署完全免费,只需自付你接入的模型 API 费用。