Skip to content

认证与安全 ​

Bearer Token ​

API 使用 Bearer Token 认证:

http
Authorization: Bearer sk-你的令牌

本站示例统一使用上述 Bearer 格式,避免混用认证来源。不要将格式写为:

text
Authorization: Bearer: sk-xxx

当前网关还兼容部分协议的认证头:Messages 路由支持 x-api-key,Gemini 原生路由支持 x-goog-api-key。这些不是所有接口通用的认证头。不要把令牌放在 URL 查询参数中,以免进入访问日志和浏览历史。

安全建议 ​

  1. 每个应用使用独立令牌,避免多人共用同一密钥。
  2. 为令牌设置合理额度和模型范围。
  3. 只在自己的服务端或受信任的本机客户端保存令牌,不写入浏览器 JavaScript、移动端安装包或公开仓库。
  4. 不要在工单、聊天截图和命令历史中展示完整令牌。
  5. 怀疑泄露时立即禁用旧令牌并创建新令牌。

浏览器直连风险

前端网页直接请求 API 会把密钥暴露给访问者。正式应用应由自己的后端持有令牌,再由前端调用业务后端。

推荐的令牌保存方式 ​

推荐:将令牌保存到当前账户的用户环境变量,一次设置,后续新终端和应用可读取。

  1. 在 Windows 搜索“环境变量”,打开“编辑账户的环境变量”;也可从“系统属性 → 高级 → 环境变量”进入。
  2. 在上方当前账户的“用户变量”中选择“新建”,保存下表的 FQHX_API_KEY;可选项仅在需要时设置。不要把令牌写入公开项目配置或终端命令历史。
  3. 逐层点击“确定”保存,然后完全退出并重新打开 Windows Terminal、PowerShell 和需要使用令牌的应用。仅新开旧终端的标签页可能仍继承旧进程的值。
用户变量名值
FQHX_API_KEY从本站控制台复制的 API 令牌
FQHX_BASE_URL(可选)https://newapi.fq-hx.com/v1;仅用于技能的自定义 API 基地址,通常无需设置

用户环境变量会保存在当前 Windows 账户配置中。保存后重新打开工具即可,无需执行检查脚本;不要导出变量列表或分享包含令牌的截图。

API 请求的统一填写方法见首页 HTTP 验证模块,各工具共用这一验证入口。

变量与地址填写约定 ​

  • 本站教程共用 FQHX_API_KEY 保存令牌。Codex 的 env_key、OpenCode 的 env 与 apiKey 引用必须与此名称一致。变量名不能代替实际令牌粘贴到客户端的 API Key 输入框。
  • 从旧版教程迁移时,在用户环境变量中保存 FQHX_API_KEY,并同步修改工具配置中的变量引用;确认新配置可用后再删除旧变量。完全退出并重开终端和客户端,使新变量生效。已有 Codex provider 使用其他 env_key 名称时,技能仍会按该配置读取,无需强制重命名。
  • FQHX_BASE_URL 是技能的可选覆盖项,应包含 /v1,例如 https://newapi.fq-hx.com/v1;设置后会覆盖技能从 Codex provider 读取的地址,不需要覆盖时请勿设置。FQHX_MODEL 和 FQHX_API_KEY_ENV 也仅供技能显式覆盖使用。
  • OpenAI 兼容客户端的 Base URL 填 https://newapi.fq-hx.com/v1;完整 HTTP 请求地址还需追加接口路径,例如 /responses。Claude Code 的 ANTHROPIC_BASE_URL 则填 https://newapi.fq-hx.com,不加 /v1,具体按对应工具教程填写。
  • OPENAI_API_KEY、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 属于客户端规定的字段或变量名,保持原名。实际服务域名仍为 newapi.fq-hx.com,不要按变量前缀改写域名。

常见认证错误 ​

HTTP 状态常见原因处理建议
401缺少令牌、格式错误或令牌无效检查 Bearer 前缀和令牌状态
403令牌或用户分组无模型权限检查令牌可用模型和分组权限
429额度不足或触发速率限制查看余额、令牌额度和请求频率

用户与进程环境变量的区别见 Microsoft PowerShell 环境变量说明。

本站提供 FQHX 接入说明;模型能力与审核规则以上游平台最新规定为准。