哼哼猫文档
本页内容

查询剩余 API 积分接口

查询当前 API Key 所属账户的剩余 API 积分。同一用户的所有 Key 共用余额,使用任意有效 Key 查询得到的都是同一笔余额。查询本身不扣 API 积分,可以用来做用量监控与自定义余量预警;系统默认也会在剩余 API 积分低于 10000、2000、300、100 与归零时发送邮件和短信预警。

🎯 基本信息

项目内容
接口地址https://api.meowload.net/openapi/v1/credits
请求方式GET
鉴权请求头 Authorization: Bearer <你的 API Key>,Key 在 开发者管理中心 获取
计费免费,不扣 API 积分

第一次接入可先看 快速开始。

📋 请求参数

没有请求体。错误消息默认为英文,需要中文时加请求头 Accept-Language: zh。

请求示例

curl https://api.meowload.net/openapi/v1/credits \
  -H "Authorization: Bearer <你的 API Key>"

🟢 成功响应

响应示例

HTTP 状态码为 200:

{ "availableCredits": 282539 }

响应字段说明

  • availableCredits 是剩余 API 积分,整数。提取接口每次成功调用后即时扣减,扣多少取决于接口与平台,规则见 开发者管理中心。
  • 做用量监控时按分钟级轮询即可,不必在每次提取前都查一次。
  • API 积分是独立的 API 计费余额,各接口按计费规则消耗积分,不等同于成功调用次数,也不与网站及桌面端的会员、AI 积分共用。

完整定义见 API 参考。

🔴 错误响应

401(API Key 无效)与 429(触发限流)的响应体形状与处理方式见 错误码。

💳 充值和管理

前往 开发者管理中心 可以充值 API 积分、查看余量与计费规则、创建及管理最多 5 个 API Key,以及设置余量预警短信的接收手机号。更换 Key 时先创建新 Key,完成业务切换后再删除旧 Key。

系统会在剩余 API 积分到达以下节点时自动发送邮件和短信预警:

  • 低于 10000
  • 低于 2000
  • 低于 300
  • 低于 100
  • 归零