Raycast Kagi搜索扩展API授权问题解析

背景介绍

Raycast平台的Kagi搜索扩展近期出现了一个影响用户体验的技术问题：即使用户正确输入了API密钥和令牌，在进行实际搜索时仍会收到"未授权"的错误提示。这个问题影响了长期使用该扩展的用户，即使他们拥有有效的Kagi订阅账户。

问题本质

经过技术分析，该问题的根源在于Kagi搜索API目前处于封闭测试阶段。这意味着：

1. 即使用户拥有Kagi付费账户，也需要单独申请API访问权限
2. API访问权限需要通过联系Kagi支持团队手动开通
3. API使用采用按量计费模式，与常规订阅服务分开计算

技术解决方案

对于遇到此问题的开发者或高级用户，可以采取以下步骤解决：

1. 向Kagi支持团队发送API访问申请邮件
2. 等待账户API权限激活
3. 在Raycast扩展中重新配置API凭证
4. 注意API使用量以避免超额费用

产品现状说明

值得注意的是，Kagi搜索API作为一项独立服务，其访问权限与以下产品特性是分离的：

• 常规网页搜索功能
• 浏览器集成功能
• 翻译应用测试权限

这种分离架构意味着即使用户参与了Kagi的其他测试项目或长期使用其服务，也需要单独申请API权限。

开发者响应

扩展维护团队已经意识到文档说明不够清晰的问题，并在最新提交的代码更新中加入了更明确的API访问说明。这一改进将帮助新用户更好地理解服务要求，避免类似的困惑。

总结建议

对于依赖Kagi搜索API的Raycast用户，建议：

1. 提前申请API测试权限
2. 关注扩展更新以获取最新功能说明
3. 合理规划API使用量以控制成本
4. 考虑备用搜索方案以应对API服务波动

这一案例也提醒开发者，在集成第三方API服务时，需要特别关注其访问策略的变化，并及时同步更新相关文档和用户通知机制。