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 演示