> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HTML 页面：每个回答的引擎原始画面

> 在 ChatGPT、Gemini、Perplexity、Meta AI、Google AI 概览或 Google AI 模式任务中添加 include.html，即可获得可分享的引擎显示画面页面。

将 `include.html` 设为 `true`，任务会返回一个链接，指向引擎为该回答显示的画面。画面保存为独立的 HTML 页面，可直接放入报告。

## 请求

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE", "payload": { "query": "best CRM for a small team", "country": "US", "include": { "html": true } } }'
```

## 支持的引擎

| taskType | 页面内容 |
| - | - |
| `CHATGPT` | 回答完成时 ChatGPT 显示的完整画面（侧边栏、问题、回答和输入框）。脚本已移除，图片已嵌入，因此打开时不会加载任何外部内容。 |
| `GEMINI` | 回答完成时 Gemini 显示的画面。脚本已移除，样式、字体和图片已嵌入，因此打开时不会加载任何外部内容。 |
| `PERPLEXITY` | 回答完成时 Perplexity 显示的画面，处理方式与 `GEMINI` 相同。 |
| `META_AI` | 回答完成时 Meta AI 显示的画面，处理方式与 `PERPLEXITY` 相同。 |
| `GOOGLE` | Google 返回的搜索结果页面，为了能安全打开，其中的脚本已被移除。Google 的样式和嵌入的缩略图会保留，链接仍在 Google 打开。 |
| `AIMODE` | Google 返回的 AI 模式页面，处理方式与 `GOOGLE` 相同。 |

其他引擎会以 `422 EVIDENCE_UNSUPPORTED` 拒绝该标志。`GET /v1/capabilities` 以 `evidence: true` 标记支持的引擎。`CHATGPT` 任务带有 `location`、请求 `CN` 或 `HK`，或通过 `continueFrom` 继续对话时，也会以同一错误拒绝。ChatGPT 只为不带设备位置回答的新对话绘制画面。

## 响应

任务的 `response` 会多出一个 `html` 对象。例如：

```json theme={"theme":"css-variables"}
{
  "html": {
    "status": "ok",
    "url": "https://api.querying.ai/v1/evidence/1791551389-5cf17d26396946be8d68bf514e1dca18.html",
    "expiresAt": "2026-11-08T13:09:49.000Z"
  }
}
```

| 字段 | 说明 |
| - | - |
| `status` | `ok`；无法保存页面时为 `failed`。 |
| `url` | 页面地址，无需 API 密钥。 |
| `expiresAt` | URL 失效的时间，即任务完成后 30 天。 |
| `error` | `status` 为 `failed` 时为 `EVIDENCE_FAILED`。 |

## 访问与保留

* URL 无需 API 密钥，可直接用于链接或报告。持有 URL 的任何人都可以在 `expiresAt` 之前打开它。
* `expiresAt` 之后，URL 返回 `404`，页面被删除。需要保留的内容请提前下载。
* 同一 IP 地址每分钟最多可下载 600 个页面，超过后返回 `429`。

## 积分

在 `CHATGPT`、`PERPLEXITY` 和 `META_AI` 上，页面在引擎价格之外收取 0.25 积分。积分在提交时冻结，仅当 `html.status` 为 `ok` 时扣除。在 `GEMINI`、`GOOGLE` 和 `AIMODE` 上，页面不额外收费。

## 页面失败时

以下情况下，任务仍会带着回答完成，`html` 返回 `{ "status": "failed", "error": "EVIDENCE_FAILED" }`：

* 无法获取引擎画面，或画面与回答不一致；
* 页面无法保存；
* 在 `GEMINI` 上，任务带有 `location`，或请求 `CN`、`DE`、`GB` 或 `IR`。这些情况总会失败。

重新提交任务即可再次尝试。

## 错误

| 状态码 | 代码 | 何时出现 |
| - | - | - |
| `422` | `EVIDENCE_UNSUPPORTED` | 该引擎无法返回 HTML 页面，或 `CHATGPT` 任务带有 `location`、`CN`、`HK` 或 `continueFrom`。 |
| `400` | `VALIDATION_ERROR` | `include.html` 不是布尔值，或请求设置了 `include.screenshot: true`。截图已停止提供，请改用 `include.html`。 |

## 相关内容

* [Markdown 与原始响应](/zh/engines/response-options.md)
* [ChatGPT](/zh/engines/chatgpt.md) · [Gemini](/zh/engines/gemini.md) · [Perplexity](/zh/engines/perplexity.md) · [Meta AI](/zh/engines/meta-ai.md) · [Google AI 概览](/zh/engines/google-ai-overviews.md) · [Google AI 模式](/zh/engines/google-ai-mode.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.