返回博客

Token 计费与充值档位说明

token 单价怎么算、为什么每次调用有一页起步量,以及充值如何降低单价。

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 参考价放在一起,充值页则用来加款。

接下来看什么