需要修改的地方
已实现的内容
所有引擎都异步运行;没有阻塞到回答返回的端点。
行为不同的地方
1. 限制按凭据、按账户和按密钥计算
1. 限制按凭据、按账户和按密钥计算
API 密钥共享账户的并发额度。通过 API 密钥提交任务和轮询状态没有固定的每分钟请求上限。以下限制仍然适用:
- API 处理容量不足时返回
503 SERVER_OVERLOADED和Retry-After,请在指定时间后重试。 - 套餐限制你的账户同时运行的任务数。超出上限的任务在队列中等待,运行中的任务结束后开始。一个账户最多可以有 1,000,000 个任务等待;超过后,提交返回
429 QUEUE_LIMIT_EXCEEDED。 - 密钥可以设置每日积分上限。超出后,提交会返回
429 KEY_DAILY_CREDIT_LIMIT,直到下一个 UTC 零点。
2. 积分按引擎计价,轮询会报告扣费
2. 积分按引擎计价,轮询会报告扣费
每个引擎有自己的价格:例如 ChatGPT 和 Perplexity 为 1 积分,Gemini 和 Google AI Overviews 为 1.25。引擎目录列出了所有价格。提交响应报告
{ "creditsToCharge": 0, "creditsCharged": 0 }。任务变为 COMPLETED 后,轮询和 webhook 会报告实际扣除的积分。失败的任务不扣费。3. 部分引擎与地区组合在提交时即被拒绝
3. 部分引擎与地区组合在提交时即被拒绝
没有可用路由的引擎和国家组合会立即返回
422 REGION_UNSUPPORTED,而不是接受一个注定失败的任务。用相同组合重试没有帮助。假设所有格式正确的提交都会被接受的客户端,需要为 422 增加分支。参见地区与位置。4. 不支持的 include 标志会被忽略或拒绝
4. 不支持的 include 标志会被忽略或拒绝
并非每个引擎都支持所有
payload.include 标志。不支持的 markdown、rawResponse 或 searchQueries 标志会被忽略。不支持的 html 或 analysis 标志返回 422,不支持的 citationAnalysis 标志返回 400。发送前请查看支持矩阵。5. Webhook 带签名
5. Webhook 带签名
每个 webhook 都携带
querying-webhook-id、querying-webhook-timestamp 和 querying-webhook-signature 请求头。忽略它们时现有接收端仍能工作,但你应当验证签名。参见 Webhook。6. 失败的任务会附加顶层 error 字符串
6. 失败的任务会附加顶层 error 字符串
对 把
FAILED 任务调用 GET /v1/async/task/{id} 会返回顶层 error 字段。它是普通字符串,而不是请求错误使用的 { code, message, timestamp } 对象。body.error 为真值视为请求失败的客户端会误读失败的任务。请根据 task.status 分支。引擎与任务类型对照
GOOGLE_AIO 返回结果页信封,AI Overview 位于可为 null 的 aioverview 成员中。参见 Google AI Overviews。
验证切换
让现有集成与 querying.ai 并行运行一段时间,对比你使用的字段,通常是response.text、response.sources[] 和 response.markdown。影子对比能发现结构检查发现不了的差异,例如来源列表的顺序不同。