API писателя

Alexandra Klepper

Thomas Steiner

Опубликовано: 22 октября 2025 г.

Объяснитель	Интернет	Расширения	Статус Chrome	Намерение
GitHub	Пробный запуск	Пробный запуск	Вид	Намерение экспериментировать

API Writer помогает создавать новый контент, соответствующий конкретной задаче. API Writer и API Rewriter входят в состав предложения Writing Assistance API .

Эти партнерские API могут помочь вам улучшить контент, создаваемый пользователями.

Варианты использования

Напишите новый контент, основанный на вашей первоначальной идее и, возможно, на контексте. Это можно использовать для:

• Пользователи службы поддержки пишут любой контент, например, обзоры, записи в блогах или электронные письма.
• Помогите пользователям лучше писать запросы в службу поддержки.
• Составьте введение для серии примеров работ, чтобы лучше отразить определенные навыки.

Не нашли свой вариант использования? Присоединяйтесь к программе раннего ознакомления и поделитесь своим мнением.

Начать

Присоединяйтесь к пробной версии Writer API, работающей в Chrome 137–148.

Зарегистрируйтесь для участия в пробной версии Origin

API Writer доступен в совместной пробной версии с API Rewriter. Чтобы начать использовать эти API:

1. Ознакомьтесь с Политикой Google в отношении запрещенного использования генеративного ИИ .
2. Перейти к пробной версии API Writer .
3. Нажмите «Зарегистрироваться» и заполните форму. В поле «Веб-источник» укажите идентификатор вашего источника или расширения: chrome-extension://YOUR_EXTENSION_ID .
4. Чтобы отправить, нажмите кнопку «Зарегистрироваться» .
5. Скопируйте предоставленный токен и добавьте его на каждую участвующую веб-страницу вашего источника или включите его в манифест расширения .
6. Начните использовать API Writer и Rewriter.

Узнайте больше о том, как начать работу с испытаниями Origin .

Добавить поддержку localhost

Чтобы получить доступ к API Writer и Rewriter на локальном хосте во время пробного периода, необходимо обновить Chrome до последней версии. Затем выполните следующие действия:

1. Перейдите по адресу chrome://flags/#writer-api-for-gemini-nano .
2. Выберите Включено .
3. Нажмите «Перезапустить» или перезапустите Chrome.

Используйте API Writer

Сначала запустите обнаружение функций, чтобы узнать, поддерживает ли браузер эти API.

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

API Writer и все остальные встроенные API ИИ интегрированы в браузер. Gemini Nano загружается отдельно при первом использовании веб-сайтом встроенного API ИИ. На практике, если пользователь уже взаимодействовал со встроенным API, он загружает модель в свой браузер.

Чтобы определить, готова ли модель к использованию, вызовите асинхронную функцию Writer.availability() . Если ответ на функцию availability() — downloadable , отслеживайте ход загрузки и информируйте пользователя, так как загрузка может занять некоторое время.

const availability = await Writer.availability(); 

Чтобы инициировать загрузку модели и запустить программу записи, проверьте активацию пользователя и вызовите функцию Writer.create() .

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

API-функции

Функция create() позволяет настроить новый объект Writer. Она принимает необязательный объект 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.   const writer = await Writer.create({     ...options,     monitor(m) {       m.addEventListener("downloadprogress", e => {         console.log(`Downloaded ${e.loaded * 100}%`);       });     }   }); } 

Назначьте ожидаемые языки

API Writer поддерживает несколько языков. Укажите ожидаемые языки ввода и контекста, а также ожидаемый язык вывода при создании сеанса. Это позволит браузеру отклонить запрос, если он не поддерживает определённую языковую комбинацию.

const writer = await Writer.create({   tone: "formal",   expectedInputLanguages: ["en", "ja", "es"],   expectedContextLanguages: ["en", "ja", "es"],   outputLanguage: "es",   sharedContext: "These are requests to write messages to teachers in a Spanish     language program, by students who may speak Spanish, Japanese, or English.     Staff expect questions to be written in Spanish." }); 

Начать писать

Существует два способа вывода записей из модели: вывод на основе запросов и потоковая передача.

Вывод на основе запроса

Для вывода на основе запроса (или «не потокового») модель ждет, пока будут сгенерированы все входные данные, обрабатывает эти входные данные как единое целое, а затем создает выходные данные.

Чтобы получить вывод на основе запроса, вызовите асинхронную функцию write() . Необходимо включить подсказку для выводимого содержимого. Вы можете добавить необязательный context для предоставления справочной информации о модели, что может помочь модели лучше соответствовать вашим ожиданиям относительно вывода.

// Request-based 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(   expectedInputLanguages: ["en"],   expectedContextLanguages: ["en"],   outputLanguage: "en", ); 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({     expectedInputLanguages: ["en"],     expectedContextLanguages: ["en"],     outputLanguage: "en",     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(); 

Демо

Политика разрешений, фреймы и веб-работники

По умолчанию API Writer доступен только окнам верхнего уровня и их iframe-ам с тем же источником. Доступ к API можно делегировать iframe-ам с другим источником с помощью атрибута политики разрешений allow="" :

<!--   The hosting site at https://main.example.com can grant a cross-origin iframe   at https://cross-origin.example.com/ access to the Writer API by   setting the `allow="writer"` attribute. --> <iframe src="https://cross-origin.example.com/" allow="writer"></iframe> 

API Writer недоступен в Web Workers. Это связано со сложностью создания ответственного документа для каждого Worker для проверки статуса политики разрешений.

Привлекайте и делитесь отзывами

API Writer и Rewriter находятся в стадии активного обсуждения и могут быть изменены в будущем. Если вы опробуете этот API и у вас есть отзывы, мы будем рады их услышать.

• Прочитайте пояснение , задайте вопросы и примите участие в обсуждении.
• Проверьте статус Chrome на предмет обновлений по реализации API в Chrome.
• Если у вас есть отзыв о реализации Chrome, отправьте сообщение об ошибке Chromium .
• Присоединяйтесь к программе предварительного просмотра, чтобы заранее ознакомиться с новыми API и получить доступ к нашему списку рассылки.

Откройте для себя все встроенные API ИИ , которые используют модели, включая Gemini Nano и другие экспертные модели, в браузере.