了解 Twitter API 价格的计费单位，计算 xaic 数据请求费用，并在接入前分清 API 美元余额与产品 Credits。
现在的 Twitter API 价格应该怎么看？
看 Twitter API 价格，最容易出错的是把“每条结果”和“每次请求或每页”当成同一种单位。先写清任务：你要查询一批已知推文 ID、按关键词搜索，还是补充用户资料。即使在同一个 API 内，这些任务也可能有不同的计费方式。
截至 2026 年 11 月 3 日核验，官方 X API 使用预付、按使用量计费。公开标准读取价格包含每条 Post 资源 $0.005、每条 User 资源 $0.010；符合条件的 Owned Reads 则适用单独的 $0.001 费率。具体费率、例外和去重规则应查看官方控制台，不要继续照抄旧的 Free/Basic/Pro 套餐表。[1]
下文的计算针对 xAIcreator 的 xaic Data API，而不是官方 X API。xaic 有独立的接口、密钥和计费规则。不同单位下的较低数字，不能证明数据覆盖或性能完全等价。
xaic 数据 API 如何计费？
本次核验的 xaic 公开价目版本为 2026-10-21-v1，下表币种均为美元。接入细节见 xaic 数据 API 文档；价格调整后，以已部署的实时价目接口为准。
| 操作 | 计费单位 | 价格 |
|---|---|---|
| 单条推文或基础用户资料 | 成功请求 | $0.00040 |
| 搜索、时间线、回复、引用或转发用户 | 成功返回的一页 | $0.00040 |
| 标准推文批量查询 | 去重后的推文 ID，每次最多 20 个 | 每 ID $0.00040 |
| 扩展用户资料 | 成功请求 | $0.00090 |
| 按承载推文 ID 查询 Article | 成功请求 | $0.005 |
十个不同 ID 的批量请求费用是 $0.004，而不是 $0.00040。搜索按页收取 $0.00040，不按该页推文数量计费，成功返回的空页也收费。接口没有承诺固定的每页条数。失败操作不收费，但结果尚不确定时，资金可能保持预留，等待对账处理。
这张表适用于标准新接入。旧版批量接口在价目中有独立条目，不应把旧单位套进新客户端。比较费用前还要确认能力匹配：引用推文发现不保证覆盖全部引用，这个 API 也没有承诺完整历史覆盖或持续流式订阅。
把任务量换算成美元预算
先定义一个有边界的任务，不要一开始就要求“抓取全部”。假设要检查 1,000 个已知推文 ID、读取 100 页搜索结果，并查询 100 次扩展资料。下表只是预算示例，不是实测结果、购买套餐，也不表示这些页面一定包含某个数量的结果。
| 示例任务 | 计算 | 预估费用 |
|---|---|---|
| 标准批量查询 1,000 个不同 ID | 1,000 × $0.00040 | $0.40 |
| 100 页成功搜索 | 100 × $0.00040 | $0.04 |
| 100 次扩展资料查询 | 100 × $0.00090 | $0.09 |
| 合计 | $0.40 + $0.04 + $0.09 | $0.53 |
额外观测、更多分页和其他操作不在上述预算中。这是使用费，不是钱包最低充值额。费用账本应使用十进制运算，避免把二进制浮点数用于精确金额累计；Python Decimal 文档解释了两者的差别。[2]
from decimal import Decimal
estimate = (
1000 * Decimal("0.00040")
+ 100 * Decimal("0.00040")
+ 100 * Decimal("0.00090")
)
print(estimate)
对周期性任务，应记录一次正常运行实际需要多少页，再据此调整下一次预算。宽泛查询可能把预算花在不相关结果上，所以先缩小研究问题。Twitter 搜索操作符指南可以帮助组织查询，但网页语法不代表 API 一定支持。
把钱包充值与请求安全分开处理
xaic 数据请求使用独立的预付 API 美元余额。创作者订阅和产品 Credits 不会为这个钱包充值。控制台提供 $10、$50、$100 档位，支付可用时也支持 $10 至 $10,000 的自定义金额。这是为后续使用充值，不是月度数据套餐。如果充值不可用，不要通过另一个产品付款来绕过。
创建只读数据 Key，按测试规模设置预算，并将密钥留在服务端。OWASP 建议按最小权限控制访问、支持撤销，并防止密钥出现在日志中。[3]新 xaic Key 默认每日 $25、累计 $100、有效期 90 天，但仍应查看控制台实际配置，不能把密钥当作无限额度。
- 发送前，为每个逻辑付费操作保存一个
Idempotency-Key。 - 网络超时后，用原路径、原参数和原键重试；已结算响应的重放不额外收费。
- 新页面或新的观测需要新键；复用已完成的键只会得到之前的观测。
- 出现
REQUEST_PENDING时停止并对账，不换新键绕过不确定状态。 - 扩大任务前检查
/balance和/usage，包括预留资金。
如果后续需要发帖，应使用独立的发布 API 和授权流程。能读取公开推文，不代表有权向该账号发布。安全的 Twitter 自动化指南解释了这种区别，以及发布前的审核要求。
Twitter API 价格常见问题
xaic 是免费 Twitter API 吗？
不是。公开价目和 OpenAPI 文件可以免费查看，上表的数据操作则收费。读取已有的监控结果也不等于创建免费持续监控。文档免费访问不能理解成赠送数据额度。
搜索结果为空也会收费吗？
在本次核验版本中，成功的空搜索页仍收费 $0.00040。检查响应，没有下一页游标就停止；反复请求空页不会改善覆盖。
第二次读取同一推文一定免费吗？
不一定。xaic 的不额外收费规则指相同操作使用相同幂等键重放已结算结果。用新键获取一次新观测，属于新的付费操作。不要把官方 X API 的资源去重规则套到 xaic 客户端。
扩大预算前需要验证什么？
核对需要的字段、有效结果覆盖、实际分页数量、错误处理和收费金额。本文是基于接口契约的计算，没有声称完成付费基准测试。如果业务需要保证历史覆盖或具体 SLA，应先确认这些要求再投入。
从一个能核对的小任务开始
选择一种操作，查看当前单价，为首次运行设置上限。值得比较的是应用能以已知费用完成什么任务，而不是哪个首页印出的数字最小。接下来可阅读 Python 首次请求教程或搜索与游标分页指南。
资料来源与延伸阅读
- X：按使用量计费官方 X 的独立规则，核验于 2026 年 11 月 3 日。
- Python：十进制运算预算计算中的精确十进制表示。
- OWASP：密钥管理指南密钥访问、生命周期和日志处理。
