OpenAPI 接口规范

本规范适用于需要通过程序自动化管理 API Key、批量查询账单、监控用量或对接自身二级中转系统的站长与开发者。

基础认证

项目	说明
基础地址	https://api.aicai.shop/api/v1
认证 Header	Authorization: Bearer sk-your-key 或 x-api-key: your-token
请求格式	Content-Type: application/json

1. 密钥管理接口

获取 API Key 列表

• 方法：GET /keys
• 查询参数：page, page_size, search, group_id

创建 API Key

• 方法：POST /keys
• 请求体：

{
  "name": "生产环境服务密钥",
  "group_id": 1,
  "quota": 100,
  "expires_in_days": 30
}

修改与撤销 API Key

• 修改额度/状态：PUT /keys/:id
• 删除密钥：DELETE /keys/:id

2. 账单与用量查询

方法	路径	功能说明
GET	/user/profile	获取当前账号余额与基础资料
GET	/groups/available	获取当前账号有权访问的分组列表
GET	/groups/rates	获取各分组下各模型的消耗倍率
GET	/usage	获取详细的 Token 消耗流水记录（支持分页和时间筛选）
GET	/usage/stats	聚合统计指定时间段内的总消耗额度

3. 标准模型调用接口

标准对话生成采用 OpenAI 兼容格式：

curl https://api.aicai.shop/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-turbo",
    "messages": [
      {"role": "user", "content": "Ping"}
    ],
    "stream": true
  }'