GET/api/auth/me

查询账户与余额

获取当前 API Key 所属账户的实时信息,包括可用余额、赠送余额、当前套餐等级(Free / Pro / Ultra)、单域名基础关键词容量上限以及 AI 体检当月剩余配额。适合外部自动化脚本在批量添加关键词或启动任务前做余额巡检与告警。

请求参数

此接口无需传递任何 Query 或 Body 参数,直接通过请求头中的 Authorization: Bearer YOUR_API_KEY 识别账户。

返回值字段说明 (data)

响应数据结构
ID
当前账户的唯一数字 ID。
Email
账户绑定的主邮箱地址。
PlanTier
当前账户套餐等级:free(基本版)、pro(专业版)或 ultra(旗舰版)。
PlanExpireAt
套餐到期时间(若为长期有效或基本版则可能为 null)。
Balance
账户当前主余额(单位:元,支持高精度小数)。
BonusBalance
账户当前活动赠送余额(单位:元)。
PromotionBalance
推广返佣可提现余额(单位:元)。
MaxKeywords
当前账户结合整体历史点击率(CTR)计算出的单域名基础关键词启用上限(Free 为 10,Pro 为 15~30,Ultra 为 500;具体单域名实际容量还会叠加该域名自身的 CTR 阶梯解锁额度)。
TotalExp
账户累计成长经验值,用于决定 VIP 折扣等级。
AiAuditMonthlyLimit
当月免费 AI 网站深度体检总额度(Free: 2 次/月,Pro: 50 次/月,Ultra: 100 次/月)。
AiAuditMonthlyUsed
当月已使用的 AI 网站深度体检次数。
GET
此请求方法通常不需要 Request Body。
curl -X GET "https://www.kuaipai.ai/api/auth/me" \
     -H "Authorization: Bearer YOUR_API_KEY"
成功响应 (200 OK)
{
  "success": true,
  "data": {
    "ID": 10086,
    "Email": "dev@example.com",
    "FullName": "SEO Team",
    "PlanTier": "pro",
    "PlanExpireAt": null,
    "Balance": 358.50,
    "BonusBalance": 20.00,
    "PromotionBalance": 0.00,
    "MaxKeywords": 30,
    "TotalExp": 2500,
    "AiAuditMonthlyLimit": 50,
    "AiAuditMonthlyUsed": 4
  }
}