Summarizer API

概念与用法

撰写长篇文章的摘要是一项常见的写作任务，而 AI 非常适合这项任务。典型用例包括：

• 提供整篇文章的摘要，以便读者判断是否值得阅读全文。
• 总结会议纪要，以便迟到的参会者可以快速了解错过的内容。
• 总结一组产品评论，以快速传达整体情绪。

Summarizer API 提供了一种异步（基于 Promise）机制，供网站将文本内容输入浏览器的内部 AI 模型，并根据指定选项请求该模型返回文本摘要。

这通过 Summarizer 接口提供的功能，以两步过程完成：

1. 使用 Summarizer.create() 静态方法创建一个 Summarizer 对象实例，并指定你想要的摘要类型选项。选项包括长度、类型（例如，“tldr”或要点）、格式（纯文本或 Markdown），以及输入和输出语言。

   注意： 如果你想检查浏览器 AI 模型是否支持你的偏好设置，可以使用 Summarizer.availability() 静态方法进行检查。

2. 运行 Summarizer.summarize() 实例方法来请求摘要。

创建 Summarizer 实例后，你可以使用 Summarizer.destroy() 实例方法将其移除。你也可以使用 AbortController 来取消待处理的 create() 或 summarize() 操作。

有关 API 工作原理的演练，请参阅 使用 Summarizer API。

接口

Summarizer 实验性的

包含 Summarizer API 的所有功能，包括检查 AI 模型可用性、创建新的 Summarizer 实例、使用它生成新的摘要等。

HTTP 标头

Permissions-Policy；summarizer 指令

控制对 Summarizer API 的访问。如果策略明确禁止使用 Summarizer API，则调用 API 方法的任何尝试都会以 NotAllowedError DOMException 失败。

安全注意事项

规范要求在创建 Summarizer 对象时，用户必须最近与页面进行过交互（需要 临时用户激活）。

此外，规范还通过 summarizer Permissions-Policy 指令控制对 API 的访问。

示例

完整示例请参阅 使用 Summarizer API。

规范

浏览器兼容性

另见

• 使用内置 AI 进行总结 (developer.chrome.com) (2025)
• chrome.dev 上的 Web AI 演示