SuperAPI AI 工具集

built-in-ai

编程与开发

查看项目

更新于 10-18 16:13

技能介绍

Built-in AI 是 Google Chrome Labs 的 web-ai-demos 仓库中的一项技能资料,用于向 AI 助手提供 Chrome 内置 AI API 的最新技术信息。它本身不是可安装的软件,而是一份供 AI 阅读并据此给出正确代码指导的技术文档。

一、用途 该资料的核心目标是纠正过时认知:早期基于单一 window.ai 对象的用法已经废弃,现在改为每个 API 独立对象。资料要求 AI 助手按照新命名给出示例,避免继续使用旧写法。

二、主要能力范围 资料覆盖以下 API 的命名、可用性检测、会话创建、流式输出、多模态输入、模型下载进度以及正式参考文档链接:

  • Prompt API:对应 window.LanguageModel,支持文本、图像、音频输入;
  • 翻译与语言检测:Translator 与 LanguageDetector;
  • 写作辅助:Summarizer、Writer、Rewriter,以及资料目录中列出的 Proofreader;
  • 通用能力:availability() 替代旧 capabilities(),destroy() 销毁模型会话,measureInputUsage()/inputQuota 等用量查询接口。

三、使用方式要点

  1. 命名迁移:window.ai.languageModel、summarizer、writer、Rewriter、translator、languageDetector 均已被弃用,改用 window.LanguageModel、window.Summarizer、window.Writer、window.Rewriter、window.Translator、window.LanguageDetector。
  2. 可用性检测:旧 capabilities() 弃用,改用 availability();且传给 availability() 的选项必须与随后传给 create() 的选项完全一致,否则可能误报可用或触发额外下载。
  3. 流式输出:所有流式接口返回 ReadableStream,各个 chunk 大小不一、彼此独立,需要自行拼接才能得到完整响应;此前“chunk 逐渐变大”的行为已不再成立。示例中在把 chunk 或完整响应插入 DOM 前需要做安全处理,唯一例外是使用 textContent 等本就安全的方式。
  4. 模型下载进度:在 create() 的 monitor 回调中监听 downloadprogress 事件,用 progress 元素向用户展示下载进度,示例给出了 progressBar.value = e.loaded、progressBar.max = e.total 的写法。
  5. 多模态会话:Prompt API 支持文本、音频(AudioBuffer、ArrayBufferView、ArrayBuffer、Blob)和视觉输入(HTMLImageElement、SVGImageElement、HTMLVideoElement 当前帧、HTMLCanvasElement、ImageBitmap、OffscreenCanvas、VideoFrame、Blob、ImageData)。
  6. polyfill 与类型:在尚不支持这些 API 的环境中可使用 prompt-api-polyfill 和 built-in-ai-task-apis-polyfills;TypeScript 项目可使用 @types/dom-chromium-ai 获得类型支持。
  7. 参考资料:资料建议通过 MDN MCP server 和 Developer Knowledge MCP server 查阅权威文档,并列出 Summarizer、Language Detector、Translator、Prompt、Writer、Rewriter、Proofreader 的参考文档链接。

四、适用场景 适合正在使用或计划使用 Chrome 内置 AI API 构建网页功能的开发者,包括文本生成、翻译、语言检测、摘要、写作与改写、校对,以及需要图像或音频输入的多模态交互场景。

五、限制与未提供信息 资料未说明浏览器版本要求、各 API 的稳定状态与正式上线时间、模型具体规格、配额上限数值、收费或价格信息、隐私与数据处理方式,也未给出 Proofreader 的完整 IDL 与示例。上述内容均暂未提供,使用时应以官方文档为准。