AgentTweet API 按返回的数据计费,而不是按请求次数计费。这篇文章说明实际落地时的几个关键数字,以及 30 天滚动充值档位如何生效。
按返回的 token 计费
每次成功调用会结算三个数字,全部在 meta 里可见:
| 字段 | 含义 |
|---|---|
tokens_raw | 上游原始返回对应的 token 数 |
tokens_flat | 扁平化之后的 token 数——你真正拿到的 |
tokens_billed | 这次调用实际扣的 token |
扁平 JSON 在进入提示词之前就去掉了噪音,相比原始报文节省 78.3% 的 token,相比其他扁平格式再省 65.8%。你按扁平后的数字付费。
每次调用至少按一页计
即使返回内容很少,一次调用也至少按一页计:2,240 tokens 是每次调用的最小计费单位。低于这个量的响应也按这个量计费,所以一次很小的查询,实际成本永远不会低于一页。
失败调用则完全相反:鉴权失败、上游报错、限流都不会计费,重试循环除了延迟之外不花钱。
档位跟着 30 天滚动充值走
档位由你最近 30 天的累计充值决定,和订阅无关:
| 档位 | 30 天滚动充值 | 每 1,000 次调用 | 每 1M tokens |
|---|---|---|---|
| Standard | 无 | $0.090 | $0.040179 |
| Volume | $100 | $0.075 | $0.033482 |
| Bulk | $1,000 | $0.058 | $0.025893 |
比 TwittrAPI 市场参考价便宜 10%–16%,量越大差距越明显。充值一次,整个滚动窗口内都按该档位结算——没有需要取消的套餐,余额本身也永不过期。
自己查一次实时价格
价格会调整,唯一可信的来源是价格接口:
curl 'https://api.skilltweet.com/v1/pricing' \
-H 'X-API-KEY: $AGENTTWEET_API_KEY'它会返回你当前的档位、token 单价,以及升到下一档还需要多少充值。定价页把这些数字和 TwittrAPI 参考价放在一起,充值页则用来加款。
接下来看什么
- 完成第一次请求:在真实响应里看这些计费字段。
- 监控与 webhook:唯一一处按月固定套餐、而不是按 token 计费的地方。