genkiln

鉴权

每个 genkiln API 请求都使用 Bearer 形式的私密 API Key 进行鉴权。

除查询模型外，所有发往 https://genkiln.com/v1 的请求都需要在 Authorization 头中携带 API Key：

HTTP
Authorization: Bearer sk_...

创建与管理 Key

  • 在控制台 → API Keys 创建 Key。新 Key 以 sk_ 开头，只显示一次。我们只保存哈希值，无法再次展示。
  • 可以创建多个 Key（例如每个环境或每个服务一个），随时删除。删除后立即失效。
  • 控制台会显示每个 Key 的最后使用时间，最多每分钟更新一次，仅供参考。
  • 同一账号下的所有 Key 共用积分余额、任务记录和 Webhook 签名密钥。

测试 Key 是否可用

GET /v1/balance 是测试 Key 最简单的方法，它返回当前积分余额：

curl https://genkiln.com/v1/balance \
  -H "Authorization: Bearer $GENKILN_API_KEY"
JSON
{ "object": "balance", "credits": 9640, "usd": 9.64 }

credits 是可用积分；usd 是按 1 积分 = 0.001 美元折算的金额。

错误

Key 缺失、格式错误、已删除或已过期时返回 401：

JSON
{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key is invalid, deleted or expired.",
    "request_id": "req_01JC8ZM2D5S1R0FQ7W3KX9YB4T"
  }
}

请求头必须是 Bearer <key> 格式。放在查询参数或请求体里的 Key 不会被识别。

保护好 Key

API Key 可以消耗你的积分。请只在自己的服务器上调用 API，不要放在用户能看到的网页或移动 App 中。

  • 把 Key 存在环境变量或密钥管理服务中，不要提交到代码仓库。
  • Key 泄露时：新建一个 Key，切换应用配置，然后删除旧 Key。
  • 开发和生产使用不同的 Key，便于单独吊销。

公开接口

GET /v1/models 和 GET /v1/models/{id} 无需 Key，可以直接在你的应用中展示模型目录和价格。见模型。