Foreverse

教程 · 任务指南

配置 BYOK，并排查 401、404、429 与模型不见了

更新 · 2026-08-10公开文档
先说答案： 到「我的→AI 模型与服务」填带版本前缀的 API Host 和 Key，测连通后设默认模型。测试可能计费，401/404/429 分别先查凭证、路径和限流。

开始前准备

  • 从供应商官方控制台复制的 API Key，并已开通所需项目权限/计费。
  • 供应商文档中的 API 基地址和模型 ID；网页聊天订阅通常不等于 API 权限。
  • 手机网络能够访问该地址。

功能入口

  • 我的 > AI 模型与服务
  • 供应商 > 测连通
  • 供应商 > 从上游 /v1/models 批量导入
  • 默认模型配置
  • 我的 > 请求记录

一步步操作

  1. 选对供应商

    打开「我的 → AI 模型与服务」，搜索签发 Key 的公司。有内置预设就优先用；只有兼容网关或自建端点才使用「添加自定义供应商」。

  2. 安全填写凭据

    把 Key 粘贴进受保护输入框，不要带标签、shell 语法、引号或前后空格。Key 绝不能进入截图、日志或客服消息。

  3. API 地址只写一次

    自定义供应商填写包含版本前缀的完整基地址；末尾不要再加 /chat/completions，Foreverse 会根据协议拼相对端点。

  4. 测连通，再添加模型

    点「测连通」，读清状态码和供应商原话。再到供应商的模型区点「从上游 /v1/models 批量导入」或「添加自定义模型」，选精确 ID，并确认它实际支持文本/视觉/图像/语音/视频中的哪一类。

  5. 设默认并做一次小请求

    打开默认模型配置，给对应模态设默认；再从真实阅读器/聊天/媒体入口发一个很小的测试。到「我的 → 请求记录」核对状态、耗时、tokens 和渠道。

怎样算成功

  • 测连通成功，并显示预期的供应商/地址。
  • 正确模态的模型选择器里能看到至少一个已启用模型。
  • 真实功能入口的小请求成功。
  • API 请求记录显示 BYOK、预期模型，且没有泄露 Key。

费用、数据与不可逆风险

  • 测连通可能发出真实 API 请求，哪怕输出很短，供应商也可能计费。
  • BYOK 费用由供应商收取，不扣 Foreverse 积分；第三方直接产生的费用 Foreverse 无法退款。
  • Key 加密保存在设备上，不应复制进任何报告。请求会发往你填写的地址，敏感文本使用自定义网关前要先确认可信。
  • 客户端显示失败不总能证明上游什么都没接收。昂贵的媒体请求不要盲目连点，先对照请求记录与供应商用量。

故障排查

401 / 403 未授权或禁止

常见原因：Key 错误/过期、项目权限不足、认证协议不兼容，或 Key 和地址不是同一服务。

现在怎么做：从正确项目重新生成/复制 API Key，确认 API 计费和权限，去掉空格，再对照官方文档地址测一次。

404 not found

常见原因：基地址缺版本前缀、端点重复拼接、协议选错，或模型 ID 在该地址不存在。

现在怎么做：只保留一次供应商基地址（常见以 /v1 结尾），去掉 /chat/completions，核对协议和模型 ID 后再测。

429 / quota exceeded / rate limit

常见原因：余额、每分钟请求数、每分钟 token 或并发上限触顶。

现在怎么做：去供应商控制台看具体配额，等窗口恢复，降低并发/输出，按意愿开通计费，或换另一个已配置供应商。

测连通成功但找不到模型

常见原因：模型没启用、被分到另一模态，或供应商列表接口没返回它。

现在怎么做：打开供应商页，启用或手动添加文档里的精确模型 ID，标对模态，再重开功能选择器。

TLS / 网络 / 超时

常见原因：当前网络到不了、证书无效、代理/VPN 干扰，或上游太慢。

现在怎么做：按官方文档核对 URL，换正常可达网络，移除不可信拦截，并看供应商状态；不要关闭证书校验。

常见问题

API 地址到底要不要带 /v1？

要按供应商文档填写完整版本前缀；不要再附加 /chat/completions 等具体操作路径，Foreverse 会拼相对端点。

为什么 ChatGPT/Claude/Gemini 会员不能直接当 API 用？

网页聊天订阅与开发者 API 计费通常是两个产品，需要在供应商控制台新建 API 项目/Key 并开通额度。

官方模型和 BYOK 能混用吗？

可以。默认模型按模态设置，各功能也能选模型，例如文字走 BYOK，生图走官方渠道。

来源与核验依据

  1. 模型与用量指南 · Foreverse · 核验于

覆盖范围与核验信息

平台Android 模型设置
App 版本v76+
路径核验日期

v58 · 配置 API Key 前检查：BYOK、Host 与 401/404/429

已发布

2026-08-12 中文版、2026-08-13 英文版发布于官网（自托管，英文版为英文旁白与字幕，App 画面为中文界面）。全片不展示密钥、不发送请求，错误码为明确标注的教学卡；旁白为 AI 合成。

配置 API Key 前检查：BYOK、Host 与 401/404/429
章节
  1. 配置前的安全边界
  2. 供应商与空白表单
  3. 教学卡：Key 与版本化 Host
  4. 默认模型按模态排列（只读）
  5. 教学卡：请求记录为空时先停
  6. 教学卡：401 / 403 凭据与权限
  7. 教学卡：404 地址、协议与模型 ID
  8. 教学卡：429 余额、配额与限流
  9. 教学卡：费用与安全重试

文中提及的第三方名称与标识归各自所有者所有。Third-party names and logos mentioned on this page belong to their respective owners.

← 教程与帮助

相关页面