获取 AI 引擎随回答显示的画面

在 ChatGPT、Gemini、Perplexity、Meta AI、Google AI 概览或 AI 模式任务中开启 include.html，即可获得引擎实际显示的回答画面链接，页面无需 API 密钥即可打开。

获得的结果

• 在 CHATGPT、GEMINI、PERPLEXITY、META_AI、GOOGLE 和 AIMODE 上使用 payload.include.html: true。
• 响应中的 html：status（ok 或 failed）、url 和 expiresAt。链接在任务完成后 30 天内有效。
• 页面无需 API 密钥即可打开，也不从外部加载任何内容，因此可以作为链接分享或嵌入报告。
• 回答字段（text、sources 等）照常返回。画面保存失败不会让任务失败。

工作原理

在 ChatGPT、Gemini、Perplexity 和 Meta AI 上，我们用真实浏览器在引擎自己的网站上提问，并在回答结束时保存画面：侧边栏、问题、带来源标签的回答和输入框。回答字段来自同一次提问，与回答不一致的画面不会保存。

保存前会去掉脚本，并把图片、样式和字体放进文件里。因此页面在任何浏览器中都以同样的画面打开，不会从引擎加载任何内容。

在 Google AI 概览和 AI 模式上，页面是 Google 为该任务返回的结果页，只去掉了脚本。AI 概览正文和来源列表以点开“显示更多”和“全部显示”的状态保存，没有脚本也能读到完整回答。

无法获取或保存画面时，html 为 { "status": "failed", "error": "EVIDENCE_FAILED" }，任务仍带着回答完成。使用 location、CN、HK 或 continueFrom 的 ChatGPT 任务，以及使用 location、CN、DE、GB 或 IR 的 Gemini 任务，始终不返回画面。

应用场景

• 在客户报告的每个数字旁附上引擎自己的画面，让读者看到用户所见的回答。
• 解析结果看起来不对时，打开页面查看品牌或来源在画面上的位置。
• 按日期记录每个引擎当天的回答。页面保留 30 天，需要更久保存的请下载。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "PERPLEXITY",
    "payload": {
      "prompt": "What are the best CRM tools for a 10-person startup?",
      "country": "US",
      "include": { "html": true }
    }
  }'

请求字段

taskTypestring必填

要运行的引擎，例如 CHATGPT 或 GOOGLE。

payload.promptstring必填

按用户在聊天框中输入的方式写的问题，最多 100,000 个字符。

payload.countrystring

提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。

payload.include.htmlboolean

设为 true 会附带 html：引擎随回答显示的画面的链接。适用于 CHATGPT、GEMINI、PERPLEXITY、META_AI、GOOGLE 和 AIMODE。默认关闭。

webhook.urlstring

你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。

响应

完成的任务如下所示，已截取部分内容。

{
  "success": true,
  "task": {
    "id": "7be8662e-5f62-48bf-a54a-7b58a2701b7c",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T01:20:07.445Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "For a 10-person startup, the strongest shortlist is **HubSpot** for a free, easy starting point; **Pipedrive** for a straightforward sales pipeline; **Zoho CRM** for budget-friendly customization; and **Attio** for a flexible, data-driven CRM.[1][2][3]\n\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://slack.com/blog/crm/best-crms-for-startups",
        "label": "Best CRMs for Startups: Tools, Benefits, and Tips"
      },
      {
        "position": 2,
        "url": "https://attio.com/f/best-crm-for-startups",
        "label": "Best CRMs for startups in 2026"
      }
    ],
    "html": {
      "status": "ok",
      "url": "https://api.querying.ai/v1/evidence/1792545851-e8cc8a32dd7f456eb807a0e09e9bc0fa.html",
      "expiresAt": "2026-11-20T01:24:11.000Z"
    }
  }
}

task.statusstring

依次为 QUEUED、PROCESSING，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。

credits.creditsChargedinteger

已完成任务扣除的积分。失败的任务为 0。

response.textstring

纯文本形式的回答。

response.sourcesarray

回答引用的页面，按引擎展示的顺序排列，含 position、url 和 label。

response.htmlobject

引擎的画面：status（ok 或 failed）、无需 API 密钥即可打开的 url，以及任务完成 30 天后的 expiresAt。保存失败时 error 为 EVIDENCE_FAILED，任务仍会带着回答完成。

获取结果

请求会立即返回 status 为 QUEUED 的任务。用 GET /v1/async/task/{id} 轮询，直到 status 变为 COMPLETED 或 FAILED；或者加上 webhook.url，在服务器上接收同样的 task、credits 和 response。任务结束后，结果保留 24 小时供查询。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

错误

EVIDENCE_UNSUPPORTEDHTTP 422

对无法返回画面的引擎开启了 include.html。只有 CHATGPT、GEMINI、PERPLEXITY、META_AI、GOOGLE 和 AIMODE 会返回画面。

VALIDATION_ERRORHTTP 400

缺少字段或取值超出范围。details 会指明该字段。

MISSING_API_KEYHTTP 401

缺少 Authorization 请求头，或密钥有误、已过期或已吊销。

INSUFFICIENT_CREDITSHTTP 402

余额低于任务价格。充值积分或升级套餐后再发送。

价格

在 ChatGPT、Perplexity 和 Meta AI 上，页面在引擎价格之外加收 0.25 积分。这 0.25 积分在提交时预留，只有 html.status 为 ok 时才扣除。在 Gemini、Google AI 概览和 AI 模式上，页面免费。开启页面后，六个引擎的每个任务都是 1.25 积分，示例中的 Perplexity 任务也扣了 1.25 积分。