使用指南
密钥与令牌
如何在控制台创建 API Key,以及在各类第三方客户端中正确填写地址和密钥。
API Key(令牌)是调用 FIM Gate 的唯一凭证,所有请求都通过它完成鉴权和计费归属。请像对待密码一样保管,不要提交到代码仓库或写进前端代码。
创建密钥
- 登录控制台,进入密钥管理页面。
- 点击创建,按需填写名称等信息。
- 创建完成后在列表中复制密钥(以
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,有的要求填到完整端点。如果连接失败,按顺序尝试以下三种写法:
https://api.gate.fim.aihttps://api.gate.fim.ai/v1https://api.gate.fim.ai/v1/chat/completions
配置完成后发一条测试消息,能收到回复即配置成功。