API Writer

Alexandra Klepper

Thomas Steiner

Data di pubblicazione: 20 maggio 2025

Spiegazione	Web	Estensioni	Stato di Chrome	Intenzione
GitHub	Origin trial	Origin trial	Visualizza	Intenzione di sperimentare

L'API Writer ti aiuta a creare nuovi contenuti conformi a un'attività di scrittura specificata. L'API Writer e l'API Rewriter fanno parte della proposta di API di assistenza alla scrittura.

Queste API partner possono aiutarti a migliorare i contenuti creati dagli utenti.

Casi d'uso

Scrivi nuovi contenuti in base all'idea iniziale e al contesto facoltativo. Questi dati potrebbero essere utilizzati per:

• Aiutare gli utenti a scrivere qualsiasi tipo di contenuto, come recensioni, post del blog o email.
• Aiutare gli utenti a scrivere richieste di assistenza migliori.
• Scrivi una bozza di introduzione per una serie di esempi di lavoro, per acquisire meglio determinate competenze.

Il tuo caso d'uso non è presente? Partecipa al programma di anteprima per condividere il tuo feedback.

Inizia

Partecipa alla prova dell'origine dell'API Writer, in esecuzione in Chrome 137-142.

Registrati alla prova dell'origine

L'API Writer è disponibile in una prova dell'origine congiunta con l'API Rewriter. Per iniziare a utilizzare queste API:

1. Accetta le Norme relative all'uso vietato dell'AI generativa di Google.
2. Vai alla prova dell'origine dell'API Writer.
3. Fai clic su Registrati e compila il modulo. Nel campo Origine web, fornisci l'origine o l'ID estensione, chrome-extension://YOUR_EXTENSION_ID.
4. Per inviare, fai clic su Registra.
5. Copia il token fornito e aggiungilo a ogni pagina web partecipante dell'origine o includilo nel file manifest dell'estensione.
6. Inizia a utilizzare le API Writer e Rewriter.

Scopri di più su come iniziare a utilizzare le prove di origine.

Aggiungere il supporto a localhost

Per accedere alle API Writer e Rewriter su localhost durante la prova dell'origine, devi aggiornare Chrome all'ultima versione. A tale scopo, procedi nel seguente modo:

1. Vai a chrome://flags/#writer-api-for-gemini-nano.
2. Seleziona Attivata.
3. Fai clic su Riavvia o riavvia Chrome.

Utilizzare l'API Writer

Per prima cosa, esegui il rilevamento delle funzionalità per verificare se il browser supporta queste API.

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

L'API Writer e tutte le altre API AI integrate sono integrate nel browser. Gemini Nano viene scaricato separatamente la prima volta che un sito web utilizza un'API AI integrata. In pratica, se un utente ha già interagito con un'API integrata, ha scaricato il modello nel browser.

Per determinare se il modello è pronto per l'uso, chiama la funzione asincrona Writer.availability(). Restituisce una stringa che può assumere quattro valori possibili:

• unavailable: il browser supporta l'API Writer, ma al momento non può essere utilizzata. Questo potrebbe essere dovuto a una serie di motivi, ad esempio spazio su disco disponibile insufficiente per scaricare il modello.
• available: il browser supporta l'API Writer e può essere utilizzata immediatamente.
• downloadable: il browser supporta l'API Writer, ma deve prima scaricare il modello.
• downloading: il browser supporta l'API Writer e sta scaricando il modello.

Per attivare il download del modello e avviare lo strumento di scrittura, chiama la funzione Writer.create(). Se la risposta a availability() è stata downloadable, ascolta l'avanzamento del download e informa l'utente, poiché il download potrebbe richiedere tempo.

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

Funzioni API

La funzione create() consente di configurare un nuovo oggetto writer. Accetta un oggetto options facoltativo con i seguenti parametri:

• tone: il tono di scrittura può riferirsi allo stile, al carattere o all'atteggiamento dei contenuti. Il valore può essere impostato su formal, neutral (predefinito) o casual.
• format: la formattazione dell'output, con i valori consentiti markdown (predefinito) e plain-text.
• length: la lunghezza dell'output, con i valori consentiti short, medium (predefinito) e long.
• sharedContext: quando scrivi più output, un contesto condiviso può aiutare il modello a creare contenuti più in linea con le tue aspettative.

Il seguente esempio mostra come inizializzare un oggetto 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}%`);
      });
    }
  });
}

Inizia a scrivere

Esistono due modi per generare l'output di scrittura dal modello: non in streaming e in streaming.

Output non in streaming

Con la scrittura non in streaming, il modello elabora l'input nel suo complesso e poi produce l'output.

Per ottenere un output non di streaming, chiama la funzione asincrona write(). Devi includere un prompt per i contenuti che vuoi che vengano scritti. Puoi aggiungere un context facoltativo per fornire al modello informazioni di base, che possono aiutarlo a soddisfare meglio le tue aspettative per l'output.

// 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",
  },
);

Output di scrittura dei flussi

Lo streaming offre risultati in tempo reale. L'output viene aggiornato continuamente man mano che vengono aggiunti e modificati gli input.

Per ottenere un writer di streaming, chiama la funzione writeStreaming() e scorri i segmenti di testo disponibili nel flusso. Puoi aggiungere un context facoltativo per fornire al modello informazioni di base, che possono aiutarlo a soddisfare meglio le tue aspettative per l'output.

// 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);
}

Condividere il contesto per più attività

Ti consigliamo di utilizzare un writer per generare più contenuti. In questo caso, è utile aggiungere sharedContext. Ad esempio, potresti voler aiutare i revisori a fornire feedback migliori nei commenti.

// 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);
}

Riutilizzare un writer

Puoi utilizzare lo stesso scrittore per creare più contenuti.

// 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)
  ),
);

Interrompi il writer

Per terminare il processo di scrittura, interrompi il controller e distruggi lo scrittore.

// 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();

Demo

Partecipare e condividere feedback

L'API Writer e l'API Rewriter sono in fase di discussione e sono soggette a modifiche in futuro. Se provi questa API e hai un feedback, ci piacerebbe conoscerlo.

• Leggi la spiegazione, poni domande e partecipa alla discussione.
• Controlla l'implementazione per Chrome in Stato di Chrome.
• Partecipa al programma di anteprima per dare un'occhiata in anteprima alle nuove API e accedere alla nostra mailing list.
• Se hai feedback sull'implementazione di Chrome, segnala un bug di Chromium.

Scopri tutte le API AI integrate che utilizzano modelli, inclusi Gemini Nano e altri modelli esperti, nel browser.