Writer API

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Alexandra Klepper

Thomas Steiner

公開日: 2025 年 5 月 20 日

商品の解説	ウェブ	拡張機能	Chrome のステータス	インテント
GitHub	オリジン トライアル	オリジン トライアル	表示	テストの目的

Writer API を使用すると、指定された作成タスクに準拠した新しいコンテンツを作成できます。Writer API と Rewriter API は、Writing Assistance API の提案の一部です。

これらのパートナー API を使用すると、ユーザー作成コンテンツの品質を高めることができます。

ユースケース

最初のアイデアとオプションのコンテキストに基づいて、新しいコンテンツを作成します。次のような場合に使用できます。

• レビュー、ブログ投稿、メールなど、あらゆる種類のコンテンツの作成をサポートします。
• ユーザーがより適切なサポート リクエストを作成できるようサポートします。
• 特定のスキルをより効果的に伝えるために、一連の作業サンプルの紹介文を作成します。

ユースケースが見つかりませんか？早期プレビュー プログラムに参加してフィードバックをお寄せください。

使ってみる

Chrome 137 ～ 142 で実施されている Writer API オリジン トライアルに参加する。

オリジン トライアルに登録する

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 のサポートを追加

オリジン トライアル中にローカルホストで 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 はブラウザに統合されています。Gemini Nano は、ウェブサイトが組み込み AI API を初めて使用するときに別途ダウンロードされます。実際には、ユーザーが組み込み API を操作した時点で、モデルがブラウザにダウンロードされています。

モデルが使用可能かどうかを確認するには、非同期の Writer.availability() 関数を呼び出します。次の 4 つの値を取る文字列を返します。

• 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() 関数を使用すると、新しい書き込みオブジェクトを構成できます。オプションの options オブジェクトを次のパラメータで受け取ります。

• tone: 文章のトーンは、コンテンツのスタイル、キャラクター、態度を指す場合があります。値は formal、neutral（デフォルト）、casual に設定できます。
• format: 出力の形式。有効な値は markdown（デフォルト）と plain-text です。
• length: 出力の長さ。有効な値は short、medium（デフォルト）、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);
  });
}

文章を作成

モデルから書き込みを出力する方法は、ストリーミングと非ストリーミングの 2 つがあります。

ストリーミング以外の出力

非ストリーミング書き込みでは、モデルは入力全体を処理してから出力を生成します。

ストリーミング以外の出力を取得するには、非同期の 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)
  ),
);

書き込みを停止する

書き込みプロセスを終了するには、コントローラを中止して書き込み元を破棄します。

// 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 API と Rewriter API は現在検討中であり、今後変更される可能性があります。この API をお試しになって、フィードバックをお寄せいただければ幸いです。

• 説明を読む、質問する、ディスカッションに参加する。
• Chrome の実装については、Chrome ステータスでご確認ください。
• 早期プレビュー プログラムに参加して、新しい API をいち早くお試しください。また、メーリング リストにもご登録いただけます。
• Chrome の実装についてフィードバックがある場合は、Chromium のバグを報告してください。

ブラウザで、Gemini Nano などのエキスパート モデルを含むモデルを使用するすべての組み込み AI API を確認する。