自带 Key · 角色扮演
角色扮演 App 怎么接自定义 API?官方直连、OpenRouter 与中转站底牌拆解
在手机角色扮演 App 里接自定义 API 只需填三样:API 基地址、Key、模型 ID。常见来源分官方直连、OpenRouter、第三方中转站和自建网关。注意走中转站时,站长服务器看得到整张角色卡和聊天全文。Foreverse(新梦)把 Key 加密存在本机,请求从手机直连你填的地址。
iPhone / iPad 版已在中国大陆以外的部分地区上架;中国大陆 App Store 暂不可用。 下载遇到问题?
往角色扮演 App 里配自定义 API,手头动作很短:填好 API 地址、粘进 Key、选定模型 ID,点一下测连通完事。真正值得你停下来琢磨的是第一格填什么网址——地址写谁家,你敲的每一句台词、整张角色卡的隐藏人设、当轮触发的世界书设定以及一长串历史对话,就原封不动发去谁家的服务器。
我们是 Foreverse(新梦)的开发者,先把自家的边界亮在明面上:Foreverse 不做流量中转,服务器碰不到你的 Key 和聊天报文;但只要你在地址栏填了第三方中转站,中转站那头就能把请求体看个底朝天。
官方直连、OpenRouter、中转站、自建网关,请求分别经过谁?
这里头没有客户端什么事,App 只是忠实把报文发往你填的地址。下面四类渠道的信息均在 2026 年 11 月 15 日对照各自官方文档核实。在 Foreverse 里怎么接自定义 API?
界面路径对照站内教程整理(Android v76 及以上版本,2026 年 8 月核对)。- 优先挑内置供应商预设进「我的 → AI 模型与服务」,先搜发 Key 的厂商名。列表里有现成预设(比如 DeepSeek、OpenRouter)就直接用;只有连第三方中转网关或自建服务时,才点「添加自定义供应商」。
- 把 Key 干干净净粘进去Key 粘进受保护输入框时别把标签、引号或前后空格一块带进去。Key 绝不能出现在截图、日志或发给任何人的消息里,求助报错时尤其注意。
- 基地址带好版本前缀,别画蛇添足自定义供应商那一栏填带版本前缀的完整基地址,尾巴上千万别再拼 /chat/completions,App 会按协议自动补齐后面的相对路径。到底加不加 /v1 一律照抄对方文档,别凭感觉盲补。
- 先点「测连通」,再拉取模型名点一下「测连通」,看清返回的状态码和上游原话。通了之后点「从上游 /v1/models 批量导入」或「添加自定义模型」,挑准模型 ID 并标好它支持的模态。注意测连通可能会发一次真请求,供应商可能计费。
- 挂上默认模型,发句短话对一遍账去默认模型配置把刚加的模型设给文字,开局随便聊句短话,转身进「我的 → 请求记录」核对状态码、耗时、token 数和渠道。自带 Key 全程跟上游结算,不扣半点 Foreverse 积分。
用了中转站,怎么把损失压到最小?
说句实在话,很多人找中转站是图个便宜,硬劝谁都别用不现实;真要用,至少把防护栏扎紧。别在角色卡、Persona 和聊天里写真实姓名、住址、手机号或任何不想被陌生人读到的内容;给中转站单独充小额,别一次充大钱;隔三差五拿 App 里的「请求记录」跟中转站后台流水对一下 token 数,两边账目对不上立马停手;另外留心「偷梁换柱」,因为后台模型映射你看不见,存一段固定开场白隔几天重跑一次,要是文风大变或单轮 token 数莫名变化,心里就该有数了。
顺带一提,尺度与成人内容能不能过审,向来由你连的那家模型商说了算,跟客户端无关(各家底线见模型供应商政策对照);而一旦过了中转站,上面还会再叠一层站长自己的规则,你同样看不到。
Foreverse 的 Key 放在哪里,谁能看到?
填进 Foreverse 的 Key 用 AES 加密存在你的手机本地,每次发消息由手机直接请求你填的目标地址,不绕道我们的服务器。但「手机直连」这四个字有个前提:只有你填原厂官方地址时才等于没有中间商;你填了中转站地址,手机就是「直连那个中转站」。App 内置了完整的 API 请求记录,每轮调了哪个模型、吃了多少输入输出 token、命中多少缓存都列得明明白白,方便你随时跟上游后台对账。目前 App 内预置了 OpenAI、Anthropic、Google、DeepSeek、xAI、OpenRouter、Kimi、GLM、Qwen 等 60 多家供应商,其余只要符合 OpenAI 或 Anthropic 兼容格式的地址都能填进来(手机连本地模型我们没逐一实测过,只敢说标准兼容地址能填)。更多细节见自带 Key 专页。
哪些人不该选自带 Key 这条路,或者不该选 Foreverse?
- 一看见 API 地址、状态码就头大的人:Foreverse 里备了现成的官方积分渠道(1 积分 = 0.0001 美元,首次登录 App 送 5,000 积分且不过期),按量随用随扣,省掉到处开户的麻烦。
- 手里只有中国大陆 App Store 账号的 iPhone 用户:Foreverse 的 iPhone 版在中国大陆 App Store 暂不可用。
- 刚需电脑网页端或跨设备云同步的人:我们既没有网页聊天端,也没做多设备云同步。
- 买 App 就是冲着连 Ollama 等本地模型去的人:手机端连本地模型我们没有实测过,不敢拍胸脯打包票。
常见问题
角色扮演 App 的自定义 API 要填哪三样?
API 基地址(Base URL)、API Key、模型 ID。基地址照抄上游文档带版本前缀的那一截,末尾千万别多粘 /chat/completions;模型 ID 得填对方列表里一字不差的真名。填完点一次测连通,再发条短消息看能不能正常回话。
中转站能看到我的聊天内容吗?
完全看得到。你的手机先把整包请求(含角色卡设定、世界书条目、历史对话和最新发言)发到中转站服务器,站长再拿他的上游 Key 替你转发;主流开源网关天生自带调用日志与外挂日志库功能,留不留底全凭站长个人操守。
OpenRouter 和中转站是一回事吗?
两码事。OpenRouter 是公开运营的聚合网关,官方文档写明推理零加价、只在充值时收 5.5% 手续费(最低 0.80 美元),且默认不存提示词与回复正文(只记 token 与延迟元数据)。当然它依然是一道中间网关,数据链路比原厂直连多经一手。
为什么测连通返回 404?
十有八九是基地址漏了版本前缀(比如该带 /v1 没带)、双写了前缀,或者末尾多粘了 /chat/completions;剩下一种常见原因是你手敲的模型 ID 在那家平台上根本不存在。翻开对方接口文档逐字比对一遍就能解。
自带 Key 的话 Foreverse 收费吗?
App 免费下载,挂自己的 Key 时所有功能敞开用,模型费由你的 API 供应商按原价收,Foreverse 不抽成也不限消息条数。免费版的门槛是最多同时存 3 本书、3 张角色卡和 3 个伴侣,买断一次 Pro 即可解除上限,没有按月订阅。
本页依据
- DeepSeek API 文档 · 首次调用 API(base_url)(2026-11-15 查看)
- DeepSeek API 文档 · 错误码(2026-11-15 查看)
- OpenRouter 文档 · FAQ(价格与手续费)(2026-11-15 查看)
- OpenRouter 文档 · Data Collection(2026-11-15 查看)
- OpenRouter 文档 · Provider Logging(2026-11-15 查看)
- New API · GitHub README(功能表与合规提醒)(2026-11-15 查看)
- One API · GitHub README(2026-11-15 查看)