可靠性

错误、重试与计费

了解失败免费、空结果计费、安全重放和有边界的重试。

先看 status

ok 表示有结果。empty 是已完成、需计费但没有结果的查询。error、timeout 和 not_supported 不扣费。fanout 中每个平台分别结算。

公开错误码共六个：rate_limited、insufficient_balance、upstream_error、not_supported、invalid_params 和 timeout。请阅读 retryable 字段和错误里的具体指引。

rate_limited：遵守 retry_after。insufficient_balance：查看钱包，必要时充值。invalid_params：修正输入后再请求。not_supported：改用文档中的替代方案，且不要把它说成等价。

upstream_error 或 timeout：按 retryable 处理。结果不明确的超时不会自动重试。不要给付费工具调用加盲目的重试循环。

HTTP 付费调用请使用 Idempotency-Key。恢复同一个逻辑请求时，用相同输入和相同 Key 复用它；不要把它用于不同的问题。重放受服务端保留期限制，不是永久缓存。

MCP 还有短时间窗口的指纹去重，但这不会让你有意重复的研究调用变成免费。请检查每个结果的 billing。

Stripe Checkout 链接只是开始付款。回到控制台不代表付款成功；只有经过验证的结算才会增加已购 credits，请在“余额”页查看交易记录。

数据调用失败不扣费。购买的额度不予退款。充值以人民币结算，每次 ¥50 至 ¥10,000。