New API 自建网关:API Key 怎么拿、怎么接进手机写小说

开源自建聚合网关(软件不是服务商):把你手里各家 Key 收进一个自己的后台做统一分发、额度管控和用量记账——手机端只对着你自己的网关说话,上游随便换。 本页是 New API 自建网关 的 BYOK 接入直答:取 Key 分步、控制台与定价页直链、接进 Foreverse 的注意事项。核实于 2026-07-18。

两个入口先放这:取 Key 去 官方下载页(本地运行,没有定价页——账单为零)。价格与免费额度随时会调,以官方页面实时为准。

在 Foreverse 里能用它做什么?

预置模板给 New API 自建网关 声明了 1 个模态位。实际可用模型以 App 内拉取的该家模型目录为准——各家上新很快,模板标记只代表接入协议已就绪。

模态在 App 里对应
文本续写 · 角色聊天 · Agent

New API 自建网关 怎么装、怎么让手机连上?

  1. 在电脑或 NAS 上用 Docker 起服务:docker run -d -p 3000:3000 -v ./data:/data calciumion/new-api:latest(生产建议 Docker Compose 带 PG/Redis)。
  2. 浏览器打开 http://<主机IP>:3000,按初始化引导设置管理员账号。
  3. 后台「渠道」页添加上游(各家真实 Key + Base URL),再到「令牌」页创建下游令牌,得到 sk- 开头的 Key——可设额度、过期时间和模型白名单。
  4. 手机与主机连同一 Wi-Fi(或 Tailscale),把 App 里 New API 的地址改成 http://<主机IP>:3000/v1,Key 填刚建的令牌。

拿到 Key 之后:接进 Foreverse 三步

  1. 打开 App 的设置 → AI 模型与服务,列表里找到 New API 自建网关(62 家预置之一,带 logo 可搜索)。
  2. 粘贴 Key,点「测连通」——发一次真实请求验证密钥与网络,顺手拉回这家的模型列表。
  3. 启用要用的模型,在「默认模型」里按模态分别指定(文本/生图/朗读/视频各设各的);之后续写、聊天、听书就都走这家了。

改 API 地址时的通用坑:地址必须带完整版本前缀(这家该是什么样,下面注意事项里写了),App 不会替你补 /v1。

New API 自建网关 专属注意

App 预置 http://localhost:3000/v1,真机使用必须把 localhost 换成部署机的内网或 Tailscale IP;套反代域名后路径仍要带 /v1。给手机端单独发一把限额+模型白名单的令牌更安全。同类 one-api 也是同一接法。

常见问题

New API 自建网关 有免费额度吗?

软件本身开源免费;真实成本是你接进网关的各家上游 Key 的用量费和这台主机本身。

填进 App 的 Key 存在哪里?

系统级加密后只存在你的手机本机,不上传、不同步到 Foreverse 任何服务器;请求从手机直连供应商官方端点,我们不经手也不加价。想撤销就去供应商控制台吊销那把 Key。

New API 自建网关 API Key 怎么拿?取 Key 到手机接入全流程(BYOK) · Foreverse · 新梦