xAI X Search 计费变化：按帖子收费、成本计算与迁移清单

先说结论：截至 2026 年 9 月 13 日，xAI 已明确宣布：X Search 将在 2026 年 9 月 21 日 12:00 PM PT 从“每 1,000 次调用 5 美元”改为“每抓取 1,000 条帖子 5 美元、每抓取 1,000 份用户资料 10 美元”。当日美国太平洋时间为 PDT（UTC−7），对应北京时间 9 月 22 日 03:00；跨时区部署仍应以官方 PT 时间为准。模型 Token 费用仍会另外计算。

这不是 SuperGrok、Grok App 或 X Premium 的涨价通知，而是开发者在 xAI API 中启用服务器端 x_search 工具时的计费单位变化。最需要立即做的，不是猜一次搜索会贵多少，而是在切换日前记录现有请求的真实总成本、搜索范围和业务结果，再固定同类业务场景、模型与过滤条件做切换后的对照。

30 秒看懂 X Search 新旧价格

以上数字来自 xAI 当前的 API Pricing 与 X Search 文档。官方价格页以美元列价，并提醒服务器端工具由模型自主决定调用次数，查询越复杂，费用越可能增加。

X Search 费用怎么算：先分工具费和 Token 费

切换前，单次请求中的 X Search 工具费可以近似理解为：

切换前 X Search 工具费 = 成功、可计费的 X Search 执行次数 × 5 / 1000（美元）

切换后，工具费公式变为：

切换后 X Search 工具费
= 抓取的帖子数 × 5 / 1000
+ 抓取的用户资料数 × 10 / 1000（美元）

一笔完整请求的费用还应加上模型 Token 等其他适用费用：

请求总费用 = X Search 资源费 + 模型 Token 费 + 其他适用工具或处理费

四个只用于理解单位的示例

后两个例子的工具费分别是旧单位下的 20 倍和 30 倍，但这只是“同一旧调用对应这些返回资源”的算术演示，不是对你实际账单的预测。真实请求可能触发多次内部搜索，也可能使用不同数量的 Token；应以 API 返回的实际计费字段为准。

旧制中的“调用”也不是所有尝试。xAI 的 Tool Usage Details 区分尝试记录与成功执行：tool_calls 可能包含失败尝试，server_side_tool_usage 记录成功执行并用于工具计费。

哪些帖子和用户资料会被计数

xAI 的规则不是只数最终答案里的链接。官方写明，搜索或线程抓取返回的每条帖子都会计数，包括父帖和引用帖；用户搜索返回的每份用户资料也会计数。因此，“最后只引用了 3 条帖子”不一定等于“只抓取了 3 条帖子”。

帖子搜索

关键词搜索与语义搜索抓取的帖子按每条 0.005 美元折算。帖子正文中的图片或视频若启用了理解能力，还可能产生相应的图像 Token 费用；官方说明查看图片或 X 视频本身没有额外工具调用费，但处理媒体所用 Token 会计费。

线程抓取

线程场景尤其容易低估。目标帖、被返回的父帖以及被返回的引用帖都可能分别成为计费资源。官方没有承诺每个线程固定返回几条内容，因此不要用“一个线程等于一条帖子”做预算。

用户搜索

用户搜索返回的资料按每份 0.01 美元折算，是帖子单价的两倍。如果任务只需要某些已知账号的帖子，应优先考虑用账号过滤缩小搜索范围，而不是先做宽泛的用户搜索再筛选。

9 月 21 日前，怎样建立自己的成本基线

xAI 已提供比手工估算更可靠的 API 使用费字段。每个推理响应的 usage.cost_in_usd_ticks 表示该请求的美元计价 API 使用费，包含适用折扣、Token 与服务器端工具费用。它不等于含税、换汇后的最终发票金额。1 美元等于 10,000,000,000 ticks。完整说明见官方 Cost Tracking。

步骤一：挑选真实业务样本

从生产或预发布流量中选取 30 至 100 个具有代表性的请求，至少覆盖简单关键词搜索、限定账号搜索、时间范围搜索、线程抓取和用户搜索。不要只测一个“你好世界”请求，也不要把包含敏感数据的完整输入复制到分析表。

步骤二：记录请求级真实成本

为每个样本保存匿名请求 ID、业务类型、模型、是否启用 X Search、日期范围、账号过滤、媒体理解开关、成功与否，以及 cost_in_usd_ticks。使用 OpenAI 兼容 SDK 或原始 Responses API 时，可以这样换算：

cost_ticks = response.usage.cost_in_usd_ticks
cost_usd = cost_ticks / 10_000_000_000

流式请求需要确保最终 usage 被客户端保留。xAI 当前 Cost Tracking 示例明确覆盖 OpenAI 兼容的 Chat Completions / REST 流式路径：启用 stream_options: { include_usage: true }，再读取最后一个包含 usage 的数据块。Responses API 或其他 SDK 不应直接套用这组参数；应先核对所用端点与 SDK 实际返回的 usage，并用请求 ID 和 Console 账单交叉验证。

步骤三：不要把引用数量当成抓取数量

截至核验日，公开 X Search 工具参数表没有提供 max_results 或同义的“最多返回 N 条结果”字段，成本追踪页也没有公开一个把“抓取帖子数”和“抓取用户资料数”逐项拆出的新 usage 字段。请求级 max_turns 可以限制代理轮次，但不能直接限制单轮并行工具调用或每次搜索返回的资源数，不能当作 max_results 使用。cost_in_usd_ticks 能告诉你请求级 API 使用费，却不必然解释每一条资源费。因此，引用数量只能作为排查线索，不能替代账单。

步骤四：切换后重放同类样本

不要对同一实时查询强求完全相同结果。更合理的做法是固定业务类型、模型、日期窗口、账号过滤和成功标准，对比每个成功任务的中位成本、P90 成本、失败率与答案质量。如果费用上升但有效任务完成率也明显提升，应比较“每个成功任务成本”，而不是只比较单次 API 请求。

控制 X Search 成本的 7 个实用动作

1. 给 X Search 单独打标。不要把纯模型请求、Web Search、X Search 和直接 X API 流量混在一个指标里。
2. 缩短日期范围。官方支持 from_date 与 to_date，格式为 ISO 8601 日期；能查 7 天就不要默认扫全年。
3. 限定账号。allowed_x_handles 最多可列 20 个账号，excluded_x_handles 也最多 20 个；两者不能在同一请求中同时设置。
4. 默认关闭不需要的媒体理解。只有确实要分析帖子图片或视频时，才开启 enable_image_understanding 或 enable_video_understanding，因为媒体处理会增加 Token 成本。
5. 把重试与代理循环设为应用级预算。公开 X Search 参数没有 max_results；max_turns 也不是结果数上限。可以在自己的应用中限制总请求次数、代理轮次、重试次数、超时和单任务可接受成本，但不要把这些应用限制写成 xAI 官方资源上限。
6. 复用自己的计算结果。对允许缓存且业务上仍新鲜的分析结果做去重，避免多个 worker 对同一查询重复发起搜索；同时遵守 X 与 xAI 的数据和开发者条款。
7. 对真实总成本报警。按请求累加 cost_in_usd_ticks，分别观察中位数、P90、每天总额与每个成功任务成本。只统计 num_server_side_tools_used 不足以覆盖新单位。

X Search、X API、Grok 和 X Premium 不是同一账单

直接 X API 的 当前定价文档将读取操作按响应返回的资源计费，将写入与动作按请求计费；一般帖子读取为每条 0.005 美元、用户读取为每份 0.01 美元，自有帖子读取则列为每条 0.001 美元。同一资源在一个 UTC 日内的重复读取去重只是 soft guarantee，不能当成绝对免计费承诺。

X API credits 与 xAI API 余额仍不共用。X 文档另有一套关联 xAI team 后的奖励：同一计费周期累计购买 X API credits 达到 200、500、1,000 美元时，可分别获得 10%、15%、20% 的独立 xAI API credits。奖励不等于合并余额，也不能反向抵扣 X API；资格、关联与到账应以 X Developer Console 实显为准。

如果你关心消费者套餐、Grok Bot、Extra Usage Credits 和 X Premium 的区别，可查看站内的 SuperGrok 套餐价格与 Grok Bot 选择指南。如果你只是估算模型提示词规模，也可以使用站内的 Token 计算器；它只能帮助估算文本 Token，不能推断 X Search 抓取了多少帖子或用户资料。

xAI API 充值、月结与退款边界

• 购买与计费入口：xAI API 按 team 记录使用量，prepaid credits 是常见方式。官方 Billing 文档说明，Monthly invoiced billing 默认关闭，需要联系 sales 或通过 Billing 页面申请；获批并把 invoiced spending limit 设为大于 0 后，系统先扣预付余额，再把上限内的后续使用计入月末账单。invoiced spending limit 为 0 时，系统只使用 prepaid credits，余额耗尽后请求才会被拒绝；开通月结后，月结使用达到该 limit 时也会停止响应，直至提高限额或补充可用预付余额。
• 币种：xAI API 公开价格页明确写明所有价格均为 USD。
• 地区与账户：官方只说明模型访问会因地理位置、账户限制等因素变化，没有在 X Search 页面给出一张可外推到所有账户的全球可用表。以 xAI Console 中团队实际可见模型和工具为准。
• 税费：公开价格表没有给出统一的税率或所有地区含税价；最终税额、VAT、付款币种和换汇成本应以团队结账页与发票为准。
• 退款：xAI 的 API Billing FAQ 说明，prepaid API credits 原则上不退款，法律要求退款的地区除外。

这里讨论的是 xAI API 账单。Web、Apple App Store、Google Play、X Premium 或第三方 API 服务商的价格、税费、取消与退款主体均可能不同，不能用其中一个渠道的收据替代另一个渠道的规则。

费用突然升高或结果异常时怎么排查

费用高于估算

1. 确认比较的是请求总成本，还是只计算了 X Search 工具费。
2. 检查模型、长上下文阈值、推理 Token、媒体理解和其他服务器端工具是否同时发生变化。
3. 查看每个响应的 cost_in_usd_ticks，按请求 ID 找出 P90 或最大值，而不是只看月总账单。
4. 确认是否存在自动重试、并行 worker 或无人约束的代理循环。
5. 如果总成本无法由公开信息解释，保存请求 ID、时间、模型、usage 和账单截图，联系 xAI 支持；不要把引用条数当成唯一证据。

响应中看不到 cost 字段

先确认 SDK 和响应端点是否支持该字段。xAI 明确提醒，Vercel AI SDK 截至其文档核验日没有在响应 metadata 中暴露 cost_in_usd_ticks；可改用 OpenAI SDK 或原始 REST API。流式请求还要确认最终 usage 数据块没有被客户端丢弃。

账号无法使用 X Search

确认 API key 属于正确 team、模型与工具在该团队的 Console 中可见，并检查地域或账户限制。不要因为消费者 Grok 可以搜索 X，就推断同一登录账号一定已经获得 xAI API 的 x_search 权限。

切换日前的迁移检查清单

• 确认代码使用的是 xAI API 的 x_search，不是 Web Search 或独立 X API。
• 记录至少一周的请求级 cost_in_usd_ticks 与成功任务指标。
• 按关键词、账号、时间范围、线程和用户搜索拆分业务类型。
• 检查 allowed_x_handles、excluded_x_handles、from_date 与 to_date 是否可以缩小范围。
• 关闭不需要的图片或视频理解，排查重试和并发重复请求。
• 设置应用侧单任务预算、日预算与异常报警，并保留请求 ID。
• 在北京时间 9 月 22 日切换后，用同类样本复测中位成本、P90 成本、失败率与答案质量。
• 发布采购或报价前，再打开官方价格页和 xAI Console 核对生效时间、单位与团队账单。

常见问题

X Search 新价格什么时候生效？

官方时间是 2026 年 9 月 21 日 12:00 PM PT。当日为 PDT（UTC−7），对应北京时间 2026 年 9 月 22 日 03:00。跨时区部署应优先保存官方 PT 时间，不要只依赖手工换算。

Web Search 也会改成按结果收费吗？

截至 2026 年 9 月 13 日，官方只宣布 X Search 改单位。价格页仍将 web_search 列为每 1,000 次调用 5 美元。不要把 X Search 的帖子与用户资料规则套到 Web Search。

父帖和引用帖真的收费吗？

是。xAI 明确写明，只要父帖或引用帖被搜索或线程抓取返回，就会按帖子计数。最终答案是否直接引用它，不是公开规则中的收费条件。

可以在参数里限制最多抓取多少条吗？

截至核验日，公开 X Search 工具参数只有账号包含或排除、起止日期、图片理解和视频理解，没有 max_results 或同义的结果数限制。请求级 max_turns 只能限制代理轮次，不能直接约束单轮并行工具调用或每次搜索返回的资源数。你可以缩小搜索范围并设置应用侧预算，但不能把提示词中的“只找 5 条”或 max_turns 当成官方计费资源上限。

新规则下，调用次数完全不重要了吗？

对 X Search 资源费而言，官方公布的新单位是抓取的帖子和用户资料，不再是调用次数。但模型可能在一个请求中进行多轮推理和搜索，调用行为仍会影响抓取量、Token、延迟和失败率，所以仍应监控代理循环。

SuperGrok 或 X Premium 可以抵扣 X Search API 费用吗？

不能据此抵扣。消费者订阅、X 会员和 xAI API team 是不同产品与账本。只有 xAI Console 显示在相应 API team 中的 credits 或发票安排，才与本文账单直接相关。

Grok 和 X Premium+ 怎么开通？

消费者有两条独立账单路径：在 grok.com 或 Grok App 订阅 SuperGrok，或者在 x.com 或 X App 订阅 X Premium+，再把同一个付费 X 账号连接到 Grok。完整的官方与第三方开通步骤、账号绑定、到账验收和退款主体，可查看站内的 Grok 与 X Premium+ 订阅、激活和不到账排查指南。这些消费者订阅不能抵扣本文的 xAI API X Search 费用。

X Search 与直接 X API 有两个公开基础数字相同，应该选哪个？

两边公开的普通帖子 0.005 美元 / 条、用户资料 0.01 美元 / 份看起来相同，但不能据此推断实际账单相同。直接 X API 另有自有帖子读取 0.001 美元 / 条，以及 UTC 日内重复读取去重的 soft guarantee；xAI X Search 没有承诺共享这些规则。需要 Grok 自动研究、综合并生成答案时，X Search 更自然，但还要支付模型 Token；需要可控端点、明确字段和直接处理数据时，应评估独立 X API。两者的访问、credits、限额、条款与工程接口不同。

怎样知道一笔请求实际花了多少钱？

读取响应 usage 中的 cost_in_usd_ticks，再除以 10,000,000,000 得到美元金额。该字段包含该请求的 Token 与服务器端工具实际费用。多轮会话需要由你的应用逐请求累加。

买错 prepaid credits 能退款吗？

xAI API Billing FAQ 的当前规则是原则上不退款，法律要求的地区除外。因此先用小额、明确的测试预算验证团队、模型、X Search 权限和成本追踪，再决定是否增加余额。

事实核验范围与仍未知的信息

• 事实核验日期：2026 年 9 月 13 日；价格规则来源页最后更新时间为 2026 年 9 月 7 日。
• 新价格、生效时间、父帖与引用帖计数、用户资料计数和 Token 另计均来自 xAI 官方文档。
• 示例费用只用于展示公式，不代表任一模型、查询或团队的固定账单。
• 公开文档尚未说明一个可预先硬限制抓取资源数的 X Search 参数，也没有公布新的帖子与资料逐项 usage 拆分字段；这些信息应标为未知。
• 所有公开 API 价格均为 USD；地区可用性、账户权限、税费、VAT、非美元结算与最终发票以本人团队页面为准。
• 直接 X API、xAI API、SuperGrok、Grok App、X Premium 和第三方 API 平台必须分开核价、购买与退款。
• 计费单位可能继续变化。2026 年 9 月 21 日前后部署或报价时，应重新核验官方价格页、X Search 文档、响应 usage 和团队发票。