额度限流接口 | 微信开放文档

# 额度限流接口

# GET /api/v1/quotas

功能: 获取额度限流信息

请求头:

x-api-key: 应用ID (header参数)

响应示例:

{
  "app_id": "app-001",
  "quotas": {
    "chat/completions": {
      "limit": 1000,
      "used": 150
    },
    "doc/reader": {
      "limit": 500,
      "used": 75
    },
    "embeddings": {
      "limit": 2000,
      "used": 300
    },
    "rerank": {
      "limit": 800,
      "used": 120
    },
    "knowledge-chat": {
      "limit": 1500,
      "used": 200
    },
    "agent-chat": {
      "limit": 1000,
      "used": 180
    },
    "knowledge-search": {
      "limit": 3000,
      "used": 450
    }
  },
  "message": "额度信息获取成功"
}

参数说明:

参数名	类型	必填	说明
x-api-key	string	是	应用ID，通过header传递，用于标识具体的应用实例

响应格式说明:

字段名	类型	说明
app_id	string	应用ID
quotas	object	额度信息字典
quotas[interface_name]	object	接口名称对应的额度信息
quotas[interface_name].limit	integer	每日限流次数
quotas[interface_name].used	integer	已使用次数
message	string	响应消息

支持的接口列表:

chat/completions - 聊天接口
doc/reader - 文档处理接口
embeddings - 嵌入向量接口
rerank - 重排序接口
knowledge-chat - 知识问答对话接口
agent-chat - 智能体对话接口
knowledge-search - 知识检索接口

数据来源: 额度信息从Redis中读取，使用以下key格式：quota:{appid}:{interface_name}

错误处理:

如果Redis连接失败，接口返回500错误
如果某个接口的额度信息获取失败，会使用默认值（limit: 1000, used: 0）
如果appid参数为空，返回400错误