额度概览
处理任务前检查可用额度
可在监控任务、内部仪表板或批处理工作流中调用剩余额度接口。它会返回精简结果，不执行性别查询。
剩余额度9,443可用请求次数
套餐状态 有效基于示例响应
到期时间1752651601UNIX timestamp
GET
剩余额度接口
查询额度信息
将 API 密钥附加到 key 查询参数。请在服务端发起请求，避免向访客暴露凭据。
https://api.genderapi.io/api/remaining?key=YOUR_API_KEYcURL
curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"凭据安全： 不要在公开的浏览器 JavaScript 中直接调用该接口。请从后端、定时任务或受保护的服务端函数中调用。
响应示例
余额与到期时间
JSON
{
"status": true,
"remaining": 9443,
"expiresAt": 1752651601
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
status | boolean | 请求成功且 API 密钥有效时为 true。 |
remaining | integer | 当前可用的 API 额度数量。 |
expiresAt | integer | 套餐到期时间，以秒为单位的 UNIX 时间戳表示。 |
运维建议
构建提前响应的额度监控
显示当前可用额度
在内部仪表板中显示余额，供运维与支持团队查看。
设置预警阈值
在余额降至零之前发出预警，为补充额度留出时间。
保护批处理工作流
任务开始前，将可用额度与计划批次大小进行比较。
预警策略示例
请根据实际流量设置阈值，不要套用统一数值。
- 正常剩余超过 20%
- 警告剩余 10%–20%
- 严重剩余不足 10%
提前规划额度耗尽情况
不要等到 API 报错才发现余额耗尽。请按合理频率监控，避免在每次单条查询前检查，并明确应用应如何暂停或重试任务。
下一篇参考