鉴权 - EggAPI

EggAPI 产品里有两类鉴权：

本文只说明公开 API Key 调用方式。

API Key 请求头

每个公开 API 请求都要把 API Key 放在 Bearer Token 请求头里：

Authorization: Bearer YOUR_API_KEY

示例：

curl https://api.eggapi.ai/v1/usage/summary \
  -H "Authorization: Bearer YOUR_API_KEY"

如果请求头缺失、格式不是 Bearer <token>、Key 被停用或过期、所属用户不是 active，后端都会拒绝请求。

请在 EggAPI dashboard 里创建和管理 API Key。创建 Key 是 dashboard session 行为，不应该从后端批处理任务或面向用户的前端直接调用。 Key 创建后请立即保存。API Key 应像密码一样处理，只放在服务端环境里使用。

POST /v1/generate 接受 API Key，也支持 dashboard playground 的 session 鉴权。

GET /v1/tasks/{id} 和 GET /v1/tasks 接受 API Key，也支持 session 鉴权。

GET /v1/usage 和 GET /v1/usage/summary 必须使用 API Key。

API Key 管理、余额和 webhook secret 管理使用浏览器 session。

{
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing Authorization header"
  }
}

{
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid Authorization format, expected 'Bearer <token>'"
  }
}

{
  "data": null,
  "error": {
    "code": "FORBIDDEN",
    "message": "User account is suspended"
  }
}