跳转到主要内容
对 Flatkey API 的每个请求都必须在 Authorization 请求头中包含有效 API 密钥,并将其作为 Bearer token 传入。你可以在 Flatkey 控制台中创建和管理密钥。

请求头格式

Flatkey API 密钥以 sk-fk- 开头。密钥区分大小写,必须与生成时完全一致。

请求示例

创建 API 密钥

  1. 登录 console.flatkey.ai
  2. 点击左侧边栏中的密钥
  3. 点击创建密钥并输入名称
  4. 复制密钥——它只会显示一次
如果密钥丢失,必须创建新密钥。旧密钥会保持有效,直到你明确撤销它。

认证错误

错误响应格式

安全最佳实践

  • 将密钥保存在环境变量中,不要写入源代码
  • 每个部署环境使用一个独立密钥
  • 密钥泄露时立即撤销
  • 生产工作负载应定期轮换密钥
切勿在客户端 JavaScript、移动应用包或公开仓库中包含 API 密钥。密钥可能被滥用并耗尽你的余额。