外观
认证与安全
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 查询参数中,以免进入访问日志和浏览历史。
安全建议
- 每个应用使用独立令牌,避免多人共用同一密钥。
- 为令牌设置合理额度和模型范围。
- 只在自己的服务端或受信任的本机客户端保存令牌,不写入浏览器 JavaScript、移动端安装包或公开仓库。
- 不要在工单、聊天截图和命令历史中展示完整令牌。
- 怀疑泄露时立即禁用旧令牌并创建新令牌。
浏览器直连风险
前端网页直接请求 API 会把密钥暴露给访问者。正式应用应由自己的后端持有令牌,再由前端调用业务后端。
推荐的令牌保存方式
推荐:将令牌保存到当前账户的用户环境变量,一次设置,后续新终端和应用可读取。
- 在 Windows 搜索“环境变量”,打开“编辑账户的环境变量”;也可从“系统属性 → 高级 → 环境变量”进入。
- 在上方当前账户的“用户变量”中选择“新建”,保存下表的
FQHX_API_KEY;可选项仅在需要时设置。不要把令牌写入公开项目配置或终端命令历史。 - 逐层点击“确定”保存,然后完全退出并重新打开 Windows Terminal、PowerShell 和需要使用令牌的应用。仅新开旧终端的标签页可能仍继承旧进程的值。
| 用户变量名 | 值 |
|---|---|
FQHX_API_KEY | 从本站控制台复制的 API 令牌 |
FQHX_BASE_URL(可选) | https://newapi.fq-hx.com/v1;仅用于技能的自定义 API 基地址,通常无需设置 |
用户环境变量会保存在当前 Windows 账户配置中。保存后重新打开工具即可,无需执行检查脚本;不要导出变量列表或分享包含令牌的截图。
bash
export FQHX_API_KEY="sk-替换为你的令牌"此设置仅对当前终端及其启动的应用生效。需要持续使用时,可手动加入自己实际使用的 shell 配置文件(zsh 通常是 ~/.zshrc,交互式 bash 通常是 ~/.bashrc),然后重开终端并从该终端启动工具;从桌面图标启动的应用不一定继承这些变量。
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 环境变量说明。