| name | fast-claw-paid-api |
| description | 为 Fast Claw 付费演示微服务获取、保存、充值并使用持久 API key。适用于需要发起购买或充值 checkout 流程、把返回的 API key 本地缓存、查询账户余额,或携带 API key 调用 Fast Claw 微服务的场景。 |
Fast Claw Paid API
优先使用随 skill 附带的客户端脚本,不要手写 HTTP 调用。这个脚本会处理本地 API key 缓存、发起首购和充值 checkout、轮询支付完成状态,并用认证头去调用服务。
快速开始
如果服务不在 http://localhost:8033,先设置 FAST_CLAW_SERVICE_URL。
先执行 python3 scripts/fast_claw_client.py status 检查本地 API key 状态。
如果还没有 API key,执行 python3 scripts/fast_claw_client.py purchase --account-name "<账户名>" --credits 10 --open-browser。
提示用户在浏览器里完成购买页。脚本会持续轮询,支付完成后把 API key 保存到 ~/.fast-claw/api-key.json,除非用户通过 FAST_CLAW_API_KEY_PATH 或兼容变量 FAST_CLAW_TOKEN_PATH 指定了别的位置。
正常调用服务时执行 python3 scripts/fast_claw_client.py invoke --prompt "..."。
需要生成耗时较长的分析报告时,执行 python3 scripts/fast_claw_client.py report --prompt "..."。这个命令会创建异步 report job,并持续轮询直到完成;如果只想先拿 job_id,加上 --no-wait,之后再用 wait-report --job-id ...。
给同一个账户充值时执行 python3 scripts/fast_claw_client.py topup --credits 10 --open-browser,不要更换 API key。
如果想验证外部跳转,创建 checkout 时传 --success-url "https://www.baidu.com" 即可。
工作流
- 先用
status 查看本地状态。
- 如果 API key 缺失或失效,执行
purchase。
- 如果服务返回余额不足或次数用尽,执行
topup。
- 需要正式调用时,执行
invoke。
- 需要测试长耗时任务时,执行
report,或者先 report --no-wait 再 wait-report。
- 如果用户已经从别的入口拿到了 API key,只需要用
set-api-key 保存一次。
命令说明
status:显示本地 API key 路径、脱敏后的 API key,以及服务端当前余额。