FIM Gate 文档
使用指南

密钥与令牌

如何在控制台创建 API Key,以及在各类第三方客户端中正确填写地址和密钥。

API Key(令牌)是调用 FIM Gate 的唯一凭证,所有请求都通过它完成鉴权和计费归属。请像对待密码一样保管,不要提交到代码仓库或写进前端代码。

创建密钥

  1. 登录控制台,进入密钥管理页面。
  2. 点击创建,按需填写名称等信息。
  3. 创建完成后在列表中复制密钥(以 sk- 开头)。

如果怀疑密钥泄露,直接在控制台停用并新建一个,旧密钥立即失效。

在自己的代码中使用

推荐通过环境变量注入,避免硬编码:

export FIM_API_KEY="sk-..."
验证密钥可用
curl https://api.gate.fim.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FIM_API_KEY" \
  -d '{"model": "gpt-4.1", "messages": [{"role": "user", "content": "ping"}]}'

在第三方客户端中使用

主流对话客户端(如 NextChat、Lobe Chat 等)一般都支持自定义 API 地址,配置两项内容即可:

  • API 地址(Base URL):填 FIM Gate 的接口地址
  • API Key:填你创建的密钥

常用客户端的逐项配置步骤见应用集成章节。不同客户端对 Base URL 的拼接规则不一致:有的会自动补 /v1,有的要求填到完整端点。如果连接失败,按顺序尝试以下三种写法:

  1. https://api.gate.fim.ai
  2. https://api.gate.fim.ai/v1
  3. https://api.gate.fim.ai/v1/chat/completions

配置完成后发一条测试消息,能收到回复即配置成功。