Jina Reader API 使用指南：令牌管理与速率限制解析

令牌余额查询方法

Jina Reader API 提供了两种方式查询剩余令牌数量：

1. 命令行查询：通过简单的 curl 命令即可获取剩余令牌信息

curl https://r.jina.ai -H 'Authorization: Bearer <您的API密钥>'

命令执行后，响应中会包含剩余令牌数量的信息。

2. Web界面查询：在Jina Reader的Web界面中输入API密钥，系统会自动显示当前账户的剩余令牌数量。

响应格式说明

当前API返回的令牌余额信息以纯文本形式展示，格式为"[Balance left] 数量"。对于需要程序化处理的应用场景，建议开发者自行解析这段文本信息。未来版本可能会增加JSON格式的响应支持，提供更结构化的数据返回。

速率限制与并发控制

使用Jina Reader API时需要注意以下速率限制规则：

1. 免费试用密钥：默认限制为每分钟20个请求(RPM)
2. 正式密钥：根据购买的套餐不同会有更高的请求限制

当超过速率限制时，API会返回明确的错误信息："Whoa there, turbo! You've hit the rate limit..."。

常见问题解决方案

1. 速率限制错误排查：

• 检查Authorization头部是否正确设置
• 确认API密钥没有拼写错误
• 验证请求频率是否超出套餐限制

2. 提高处理能力：

• 对于需要高并发的场景，建议购买更高级别的API套餐
• 合理设计请求间隔，避免短时间内集中发送大量请求

私有化部署建议

对于有特殊需求的企业用户，可以考虑将Jina Reader部署在私有环境中。私有化部署可以提供：

• 完全自主的速率控制策略
• 不受公共API限制的并发处理能力
• 更高的数据隐私和安全性

私有化部署需要一定的技术准备，建议联系Jina官方获取详细的部署指南和技术支持。