Rewriter API

发布时间:2025 年 5 月 20 日

说明类视频 Web 扩展程序 Chrome 状态 意向
GitHub 源试用 源试用 源试用 源试用 视图 实验意向

Rewriter API 可帮助您修改和重构文本。此 API 和 Writer API写作辅助 API 提案的一部分。

这些 API 可帮助您改进用户创建的内容。

使用场景

通过延长或缩短现有文本,或更改语气来优化文本。例如,您可以:

  • 改写一封简短的电子邮件,使其听起来更礼貌、更正式。
  • 建议修改客户评价,以帮助其他客户了解反馈或消除有害内容。
  • 调整内容格式以满足特定受众群体的期望。

您的使用场景是否未列出?加入抢先试用计划,分享您的反馈。

开始使用

加入 Rewriter API 源试用,该试用在 Chrome 137 至 142 中进行。

查看硬件要求

开发者和在 Chrome 中使用这些 API 运行功能的用户必须满足以下要求。其他浏览器可能有不同的运行要求。

语言检测器和翻译器 API 可在桌面版 Chrome 中使用。这些 API 不适用于移动设备。当满足以下条件时,Prompt API、Summarizer API、Writer API 和 Rewriter API 可在 Chrome 中正常运行:

  • 操作系统:Windows 10 或 11;macOS 13 及更高版本(Ventura 及更高版本);或 Linux。使用 Gemini Nano 的 API 尚不支持 Android 版 Chrome、iOS 版 Chrome 和 ChromeOS 版 Chrome。
  • 存储空间:包含 Chrome 个人资料的卷上至少有 22 GB 的可用空间。
  • GPU:VRAM 严格大于 4 GB。
  • 网络:无限流量或不按流量计费的网络连接。

Gemini Nano 的确切大小可能会略有不同。如需了解当前大小,请访问 chrome://on-device-internals 并前往模型状态。 打开列出的文件路径,以确定模型大小。

报名参加源试用

Rewriter API 与 Writer API 一起提供,以供进行联合源试用。 如要开始使用这些 API,请执行以下操作:

  1. 确认《Google 生成式 AI 使用限制政策》
  2. 前往 Rewriter API 来源试用
  3. 点击注册,然后填写表单。在“Web 来源”字段中,提供您的来源或扩展程序 ID chrome-extension://YOUR_EXTENSION_ID
  4. 如需提交,请点击注册
  5. 复制提供的令牌,并将其添加到来源中的每个参与网页,或将其包含在扩展程序清单中。
  6. 开始使用 Rewriter API。

详细了解如何开始使用源试用

添加对 localhost 的支持

如需在源试用期间在 localhost 上访问 Writer 和 Rewriter API,您必须将 Chrome 更新到最新版本。然后,请按下列步骤操作:

  1. 前往chrome://flags/#rewriter-api-for-gemini-nano
  2. 选择已启用
  3. 点击重新启动或重启 Chrome。

使用 Rewriter API

首先,运行功能检测,看看浏览器是否支持这些 API。


if ('Rewriter' in self) {
  // The Rewriter API is supported.
}

Rewriter API 和所有其他内置 AI API 都已集成到浏览器中。首次有任何网站使用内置 AI API 时,系统会单独下载 Gemini Nano。实际上,如果用户已经与内置 API 互动过,他们就已将模型下载到浏览器中。

如需确定模型是否已准备就绪,请调用异步 Rewriter.availability() 函数。它会返回一个字符串,该字符串可以采用以下四种可能的值:

  • unavailable:浏览器支持 Rewriter API,但目前无法使用。这可能是由多种原因造成的,例如没有足够的可用磁盘空间来下载模型。
  • available:浏览器支持 Rewriter API,可立即使用。
  • downloadable:浏览器支持 Rewriter API,但需要先下载模型。
  • downloading:浏览器支持 Rewriter API,并且目前正在下载模型。

如需触发模型下载并启动重写器,请调用 Rewriter.create() 函数。如果对 availability() 的响应为 downloadable,请监听下载进度并告知用户,因为下载可能需要一些时间。

const rewriter = await Rewriter.create({
  monitor(m) {
    m.addEventListener("downloadprogress", e => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  }
});

API 功能

借助 create() 函数,您可以配置新的重写器对象。它采用一个可选的 options 对象,该对象包含以下参数:

  • tone写作语气是指内容的风格、特征或态度。该值可以设置为 more-formalas-is(默认值)或 more-casual
  • format:输出格式,允许的值为 as-is(默认值)、markdownplain-text
  • length:输出的长度,允许的值为 shorteras-is(默认值)和 longer
  • sharedContext:在重写多段内容时,共享上下文有助于模型创建更符合您期望的内容。

以下示例展示了如何初始化 rewriter 对象:

const options = {
  sharedContext: 'This is an email to acquaintances about an upcoming event.',
  tone: 'more-casual',
  format: 'plain-text',
  length: 'shorter',
};

const available = await Rewriter.availability();
let rewriter;
if (available === 'unavailable') {
  // The Rewriter API isn't usable.
  return;
}
if (available === 'available') {
  // The Rewriter API can be used immediately .
  rewriter = await Rewriter.create(options);
} else {
  // The Rewriter can be used after the model is downloaded.
  rewriter = await Rewriter.create(options);
  rewriter.addEventListener('downloadprogress', (e) => {
    console.log(e.loaded, e.total);
  });
}

开始重写

模型输出内容的方式有两种:非流式和流式。

非流式传输输出

对于非流式重写,模型会整体处理输入,然后生成输出。

如需获取非流式输出,请调用异步 rewrite() 函数。您必须包含要改写的初始文本。您可以添加可选的 context 来提供模型背景信息,这可能有助于模型更好地满足您对输出的期望。

// Non-streaming
const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});
const result = await rewriter.rewrite(reviewEl.textContent, {
  context: "Avoid any toxic language and be as constructive as possible."
});

流重写输出

流式传输可提供实时结果。随着输入内容添加和调整,输出内容会不断更新。

如需获取流式重写器,请调用 rewriteStreaming() 函数,并遍历流中可用的文本段。您可以添加可选的 context 来为模型提供背景信息,这有助于模型更好地满足您对输出的期望。

const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});

const stream = rewriter.rewriteStreaming(reviewEl.textContent, {
  context: "Avoid any toxic language and be as constructive as possible.",
  tone: "more-casual",
});

for await (const chunk of stream) {
  composeTextbox.append(chunk);
}

为多个任务共享上下文

您可能需要使用 rewriter 生成多条内容。在这种情况下,添加 sharedContext 会很有用。例如,您可能希望帮助审核者在评论中提供更出色的反馈。

// Shared context and per writing task context
const rewriter = await Rewriter.create({
  sharedContext: "This is for publishing on [popular website name], a business and employment-focused social media platform."
});

const stream = rewriter.rewriteStreaming(
  "Love all this work on generative AI at Google! So much to learn and so many new things I can do!",
  {
    context: "The request comes from someone working at a startup providing an e-commerce CMS solution.",
    tone: "more-casual",
  }
);

for await (const chunk of stream) {
  composeTextbox.append(chunk);
}

重复使用重写器

您可以使用同一重写器来修改多篇内容。如果将重写器添加到反馈或评论工具中,以帮助撰写者提供有意义且有用的反馈,这可能特别有用。

// Reusing a rewriter
const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});

const rewrittenReviews = await Promise.all(
  Array.from(
    document.querySelectorAll("#reviews > .review"),
    (reviewEl) => rewriter.rewrite(reviewEl.textContent, {
      context: "Avoid any toxic language and be as constructive as possible.",
      tone: "more-casual",
    })
  ),
);

停止重写器

如需结束重写流程,请中止控制器并销毁 rewriter

// Stop a rewriter
const controller = new AbortController();
stopButton.onclick = () => controller.abort();

const rewriter = await Rewriter.create({ signal: controller.signal });
await rewriter.rewrite(reviewEl.textContent, { signal: controller.signal });

// Destroy a rewriter
rewriter.destroy();

演示

互动和分享反馈

Writer 和 Rewriter API 正在积极讨论中,将来可能会发生变化。如果您试用了此 API 并有反馈意见,欢迎随时告诉我们。

探索浏览器中所有使用模型的内置 AI API,包括 Gemini Nano 和其他专家级模型。