鉴权

所有接口都通过 API Key 鉴权。API Key 代表你的账户，调用产生的费用从账户余额扣除。

创建 API Key#

  1. 登录控制台，进入「API Keys」。
  2. 点击「创建 API Key」，填写名称，按需设置下文的访问限制。
  3. 创建后复制密钥（以 sk- 开头）并妥善保存。

在请求中使用#

在每个请求的 Header 中携带：Authorization: Bearer YOUR_API_KEY。

cURL
curl https://api-ganfonxai.gangfeng.net/v1/models \
  -H "Authorization: Bearer $API_KEY"

密钥缺失、错误或已停用时返回 HTTP 401。

访问限制#

每个 API Key 都可以单独设置以下限制，适合按业务线或按项目分配密钥：

  • 额度上限：该密钥最多可消费的金额，用尽后返回 403。
  • 模型限制：只允许调用指定模型。
  • IP 白名单：只接受来自指定服务器 IP 的请求。
  • 过期时间：到期后自动失效。

安全建议#

不要在前端或客户端暴露 API Key

API Key 只应保存在你的服务端（环境变量或密钥管理服务），不要写进网页、App 或公开代码仓库。终端用户的请求应先到你的服务端，再由服务端调用本平台。
  • 为不同环境（开发、测试、生产）分别创建密钥，并设置额度上限。
  • 生产环境的密钥建议配置 IP 白名单。
  • 怀疑密钥泄露时，立即在控制台删除或停用该密钥，再创建新密钥替换。
  • 定期在 调用日志 中检查异常调用。