跳转到主要内容
querying.ai 实现了回答引擎 API 通用的异步任务协议。对于下列端点,请求和响应结构一致,因此能正常工作的客户端通常只需更换 base URL 和密钥。

需要修改的地方

把 API 密钥常量换成在 API 密钥页面创建的 querying.ai 密钥。webhook URL、幂等键、任务类型和响应解析都保持原样。

已实现的内容

所有引擎都异步运行;没有阻塞到回答返回的端点。

行为不同的地方

API 密钥共享账户的并发额度。通过 API 密钥提交任务和轮询状态没有固定的每分钟请求上限。以下限制仍然适用:
  • API 处理容量不足时返回 503 SERVER_OVERLOADED 和 Retry-After,请在指定时间后重试。
  • 套餐限制你的账户同时运行的任务数。超出上限的任务在队列中等待,运行中的任务结束后开始。一个账户最多可以有 1,000,000 个任务等待;超过后,提交返回 429 QUEUE_LIMIT_EXCEEDED。
  • 密钥可以设置每日积分上限。超出后,提交会返回 429 KEY_DAILY_CREDIT_LIMIT,直到下一个 UTC 零点。
大量提交时,请发送批次,而不是大量单个请求。参见积分与限制和批次与网格。
每个引擎有自己的价格:例如 ChatGPT 和 Perplexity 为 1 积分,Gemini 和 Google AI Overviews 为 1.25。引擎目录列出了所有价格。提交响应报告 { "creditsToCharge": 0, "creditsCharged": 0 }。任务变为 COMPLETED 后,轮询和 webhook 会报告实际扣除的积分。失败的任务不扣费。
没有可用路由的引擎和国家组合会立即返回 422 REGION_UNSUPPORTED,而不是接受一个注定失败的任务。用相同组合重试没有帮助。假设所有格式正确的提交都会被接受的客户端,需要为 422 增加分支。参见地区与位置。
并非每个引擎都支持所有 payload.include 标志。不支持的 markdown、rawResponse 或 searchQueries 标志会被忽略。不支持的 html 或 analysis 标志返回 422,不支持的 citationAnalysis 标志返回 400。发送前请查看支持矩阵。
每个 webhook 都携带 querying-webhook-id、querying-webhook-timestamp 和 querying-webhook-signature 请求头。忽略它们时现有接收端仍能工作,但你应当验证签名。参见 Webhook。
对 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。影子对比能发现结构检查发现不了的差异,例如来源列表的顺序不同。