---
title: "网页阅读"
method: POST
path: "/paas/v4/reader"
tags: ["工具 API"]
---

# 网页阅读

`POST /paas/v4/reader`

读取并解析指定 `URL` 的网页内容，可选择返回格式、支持控制缓存、图片保留与摘要选项等。点击 **Try it** 按钮可快速试用。

## Request body

- ReaderRequest
  - `url` string, required — 需要抓取的`url`
  - `timeout` integer — 请求超时时间（秒），默认值 `20`
  - `no_cache` boolean — 是否禁用缓存（`true`/`false`），默认值 `false`
  - `return_format` string — 返回格式（如：`markdown`、`text`等），默认值 `markdown`
  - `retain_images` boolean — 是否保留图片（`true`/`false`），默认值 `true`
  - `no_gfm` boolean — 是否禁用 `GitHub Flavored Markdown`（`true`/`false`），默认值 `false`
  - `keep_img_data_url` boolean — 是否保留图片数据 `URL`（`true`/`false`），默认值 `false`
  - `with_images_summary` boolean — 是否包含图片摘要（`true`/`false`），默认值 `false`
  - `with_links_summary` boolean — 是否包含链接摘要（`true`/`false`），默认值 `false`

## Response `200`

业务处理成功

- ReaderResponse
  - `id` string — 任务 `ID`
  - `created` integer — 请求创建时间，是以秒为单位的 `Unix` 时间戳
  - `request_id` string — 由用户端传递，需要唯一；用于区分每次请求的唯一标识符。如果用户端未提供，平台将默认生成。
  - `model` string — 模型编码
  - `reader_result` object — 网页阅读结果
    - `content` string — 网页解析后的主要内容（正文、图片、链接等标记）
    - `description` string — 网页简要描述
    - `title` string — 网页标题
    - `url` string — 网页原始地址
    - `external` object — 网页引用的外部资源对象
      - `stylesheet` object — 外部样式表集合
    - `metadata` object — 页面元数据信息
      - `keywords` string — 页面关键词
      - `viewport` string — 页面视口设置
      - `description` string — 元数据描述
      - `format-detection` string — 格式检测设置，如`telephone=no`

## Other responses

- `default` — 请求失败。

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)