Writer API

发布时间:2025 年 5 月 20 日

解说 Web 扩展程序 Chrome 状态 意向
GitHub 在标志后面 Origin 试用 在标志后面 Origin 试用版 视图 意图进行实验

Writer API 可帮助您创建符合指定写作任务的新内容。Writer API 和 Rewriter API 属于写作辅助 API 提案的一部分。

这些合作伙伴 API 可帮助您改进用户创作的内容。

使用场景

根据您的初始想法和可选背景信息撰写新内容。这可能用于:

  • 支持用户撰写任何类型的内容,例如评价、博文或电子邮件。
  • 帮助用户撰写更妥善的支持请求。
  • 为一系列作品样本起草一份简介,以便更好地展示特定技能。

您的用例是否缺失?加入抢先体验计划,分享您的反馈。

开始使用

加入 Writer API 源试用,该试用在 Chrome 137 到 142 中运行。

查看硬件要求

语言检测器 API 和 Translator API 仅适用于桌面版 Chrome。

当满足以下条件时,Prompt API、Summarizer API、Writer API 和 Rewriter API 可在 Chrome 中正常运行:

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

这些要求适用于您在开发过程中以及使用您构建的功能的用户。

注册源代码试用

Writer API 可与 Rewriter API 一起在源试用中使用。如需开始使用这些 API,请执行以下操作:

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

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

添加了对 localhost 的支持

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

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

使用 Writer API

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

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

Writer API 和所有其他内置 AI API 都已集成到浏览器中。当任何网站首次使用内置 AI API 时,系统会单独下载 Gemini Nano。在实践中,如果用户已与内置 API 互动,则表示他们已将模型下载到其浏览器。

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

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

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

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

API 功能

借助 create() 函数,您可以配置新的 Writer 对象。它采用一个可选的 options 对象,该对象具有以下参数:

  • tone写作风格可以指内容的风格、特征或态度。此值可以设置为 formalneutral(默认值)或 casual
  • format:输出格式,允许的值为 markdown(默认值)和 plain-text
  • length:输出的长度,允许的值为 shortmedium(默认值)和 long
  • sharedContext:在编写多个输出时,共享上下文有助于模型生成更符合您预期的内容。

以下示例演示了如何启动 writer 对象:

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

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

开始撰写

您可以通过以下两种方式从模型输出写入内容:非流式和流式。

非流式输出

在非流式写入模式下,模型会将输入作为一个整体进行处理,然后生成输出。

如需获取非流式输出,请调用异步 write() 函数。您必须提供要让系统撰写的内容的提示。您可以添加一个可选的 context 来提供模型背景信息,这可能会帮助模型更好地满足您对输出结果的预期。

// Non-streaming
const writer = await Writer.create();
const result = await writer.write(
  "An inquiry to my bank about how to enable wire transfers on my account.", {
    context: "I'm a longstanding customer",
  },
);

流式写入输出

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

如需获取流式写入器,请调用 writeStreaming() 函数并迭代流中可用的文本片段。您可以添加一个可选的 context 来提供模型背景信息,这可能会帮助模型更好地满足您对输出结果的预期。

// Streaming
const writer = await Writer.create();
const stream = writer.writeStreaming(
  "An inquiry to my bank about how to enable wire transfers on my account.", {
    context: "I'm a longstanding customer",
  },
);
for await (const chunk of stream) {
  composeTextbox.append(chunk);
}

共享多个任务的上下文

您可能需要使用 writer 生成多段内容。在这种情况下,添加 sharedContext 会很有用。例如,您可能需要帮助审核员在评论中提供更实用的反馈。

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

const stream = writer.writeStreaming(
  "Write a blog post about how I love all this work on gen AI at Google!" +
  "Mention that there's 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."}
);

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

重复使用写入器

您可以使用同一写入器创建多篇内容。

// Reuse a writer
const writer = await Writer.create({ tone: "formal" });

const reviews = await Promise.all(
  Array.from(
    document.querySelectorAll("#reviews > .review"),
    (reviewEl) => writer.write(reviewEl.textContent)
  ),
);

停止 writer

如需结束写入进程,请中止控制器并销毁写入器。

// Aborting a writer
const controller = new AbortController();
stopButton.onclick = () => controller.abort();

const writer = await Writer.create({ signal: controller.signal });
await writer.write(reviewEl.textContent, { signal: controller.signal });

// Destroying a writer
writer.destroy();

演示

互动和分享反馈

Writer 和 Rewriter API 正在积极讨论中,未来可能会发生变化。如果您试用此 API 并有反馈,我们非常期待收到您的反馈。

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