认证方式

Geeknow API 支持 API Key 认证、原生兼容认证头和浏览器登录态三种访问方式。调用前先确认目标接口使用公开 API 鉴权还是浏览器登录态。

Bearer Token

用于大多数公开 API 接口，包括：

请求头：

Authorization: Bearer YOUR_API_KEY

用于 POST /v1/messages 等 Claude 原生格式页面：

x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01

用于 GET /v1beta/models 与 POST /v1beta/models/{model}:{action}：

x-goog-api-key: YOUR_API_KEY

也兼容 ?key=YOUR_API_KEY 的查询参数风格。

用于 /api/user/*、后台管理和部分前端仪表盘接口。典型特征：

GET /api/oauth/state

成功响应：

{
  "success": true,
  "message": "",
  "data": "a1b2c3d4e5f6"
}

GET /api/oauth/{provider}

这个接口用于 OAuth 浏览器回调。完成 state 校验和用户授权后，会绑定或创建账户并建立登录态。常见 provider 由实际启用的 OAuth 配置决定，例如：

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "param": "",
    "code": "invalid_api_key"
  }
}

{
  "success": false,
  "message": "无效的令牌"
}