Proofreader API

Thomas Steiner

Alexandra Klepper

Yayınlanma tarihi: 4 Eylül 2025

Açıklayıcı	Web	Uzantılar	Chrome Durumu	Amaç
GitHub	Origin denemesi	Origin denemesi	Görünüm	Prototip oluşturma amacı

Gözden geçirme, dil bilgisi, yazım ve noktalama hatalarını bulup düzeltme işlemidir. Tarayıcılar ve işletim sistemleri, Google Dokümanlar gibi yazma araçlarına giderek daha fazla yazım denetimi özelliği ekliyor.

Proofreader API ile web uygulamanıza veya uzantınıza yerleşik yapay zeka ile etkileşimli yazım denetimi sağlayabilirsiniz. Bu API aşağıdaki işlevleri sunar:

• Düzeltme: Dil bilgisi, yazım ve noktalama açısından kullanıcı girişlerini düzeltir.
• Etiketler: Her düzeltmeyi hata türüne göre etiketleyin.
• Açıklama: Hatayı veya düzeltmenin neden gerekli olduğunu basit bir dille tanımlayın.

Kullanım alanları

Proofreader API'yi kullanmak istemenizin birçok nedeni olabilir. Örneğin:

• Gönderi gönderilmeden önce forum mesajlarında, makalelerdeki yorumlarda ve e-postalarda düzeltme önerin.
• Not alma işlemi sırasında düzeltmeler yapma

Kullanım alanınız eksik mi? Geri bildiriminizi paylaşmak için erken önizleme programına katılın.

Başlayın

Chrome 141-145'te çalışan Proofreader API kaynak denemesine katılın.

localhost için destek ekleme

Kaynak denemesi sırasında Proofreader API'ye localhost'ta erişmek için Chrome'u en son sürüme güncellemeniz gerekir. Ardından, aşağıdaki adımları uygulayın:

1. Şuraya git: chrome://flags/#proofreader-api-for-gemini-nano.
2. Etkin'i seçin.
3. Yeniden başlat'ı tıklayın veya Chrome'u yeniden başlatın.

Denemeye kaydolma

Proofreader API'yi kullanmaya başlamak için aşağıdaki adımları uygulayın:

1. Google'ın Üretken Yapay Zeka Yasaklanan Kullanım Politikası'nı kabul edin.
2. Proofreader API kaynak denemesine gidin.
3. Kaydol'u tıklayın ve formu doldurun. Web kaynağı alanına kaynağınızı veya uzantı kimliğinizi (chrome-extension://YOUR_EXTENSION_ID) girin.
4. Göndermek için Kaydol'u tıklayın.
5. Sağlanan jetonu kopyalayın ve kaynağınızdaki her katılımcı web sayfasına ekleyin veya uzantı manifestinize dahil edin.
   • Uzantı oluşturuyorsanız Uzantılar için deneme talimatlarını uygulayın.
6. Proofreader API'yi kullanmaya başlayın.

Kaynak denemelerini kullanmaya başlama hakkında daha fazla bilgi edinin.

Proofreader API'yi kullanma

Modelin kullanıma hazır olup olmadığını belirlemek için Proofreader.availability() işlevini çağırın. availability() yanıtı "downloadable" ise indirme işleminin ilerleme durumunu dinleyin ve kullanıcıyı bilgilendirin. İndirme işlemi zaman alabilir.

const options = {
  expectedInputLanguages: ['en'],
};
const available = if (Proofreader.availability("downloadable") === true);

İndirme işlemini tetiklemek ve düzeltme okuyucuyu başlatmak için kullanıcı etkinleştirmesini kontrol edin. Ardından, eşzamansız Proofreader.create() işlevini çağırın.

const session = await Proofreader.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
  ...options,
});

Proofreader nesnesi oluşturma

Proofreader oluşturmak için Proofreader.create() işlevini kullanın.

const proofreader = await Proofreader.create({
  expectedInputLanguages: ["en"],
  monitor(m) {
    m.addEventListener("downloadprogress", e => {
      console.log(Downloaded ${e.loaded * 100}%);
    });
  }
};

create() yöntemi aşağıdaki seçenekleri içerir:

• expectedInputLanguages: Beklenen giriş dillerinin dizisi.

Açıklayıcıdaki includeCorrectionTypes ve includeCorrectionExplanation seçenekleri desteklenmez.

Kullanıcı metnini düzeltmeye başlama

Giriş metnindeki düzeltmeleri almak için proofread() işlevini kullanın:

const proofreadResult = await proofreader.proofread(
  'I seen him yesterday at the store, and he bought two loafs of bread.',
);

Düzeltmeler, bir ProofreadResult türüdür. corrected özelliğinde tamamen düzeltilmiş girişi ve corrections dizisindeki düzeltme listesini bulun:

let inputRenderIndex = 0;

console.log(proofreadResult.correction);

for (const correction of proofreadResult.corrections) {
  // Render part of input that has no error.
  if (correction.startIndex > inputRenderIndex) {
    const unchangedInput = document.createElement('span');
    unchangedInput.textContent = input.substring(inputRenderIndex, correction.startIndex);
    editBox.append(unchangedInput);
  }
  // Render part of input that has an error and highlight as such.
  const errorInput = document.createElement('span');
  errorInput.textContent = input.substring(correction.startIndex, correction.endIndex);
  errorInput.classList.add('error');
  editBox.append(errorInput);
  inputRenderIndex = correction.endIndex;
}

// Render the rest of the input that has no error.
if (inputRenderIndex !== input.length){
  const unchangedInput = document.createElement('span');
  unchangedInput.textContent = input.substring(inputRenderIndex, input.length);
  editBox.append(unchangedInput);
}

İzin politikası, iframe'ler ve Web Workers

Varsayılan olarak, Proofreader API yalnızca en üst düzey pencerelerde ve aynı kaynaklı iFrame'lerde kullanılabilir. API'ye erişim, Permission Policy allow="" özelliği kullanılarak kaynaklar arası iFrame'lere devredilebilir:

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

Proofreader API, Web Workers'da kullanılamaz. Bunun nedeni, İzin Politikası durumunu kontrol etmek için her çalışan adına sorumlu bir belge oluşturmanın karmaşık olmasıdır.

Demo

Proofreader API Playground ile denemeler yapın.

Etkileşim kurma ve geri bildirim paylaşma

Proofreader API aktif olarak tartışılmaktadır ve gelecekte değişebilir. Bu API'yi denerseniz geri bildiriminizi bizimle paylaşmanızı rica ederiz.

• Açıklamayı okuyun, soru sorun ve tartışmaya katılın.
• Chrome'daki uygulamayı Chrome Status'ta inceleyin.
• Mozilla Standartları ve WebKit Standartları konumunu okuyun.
• Yeni API'leri erken incelemek ve posta listemize erişmek için erken önizleme programına katılın.
• Chrome'un uygulamasıyla ilgili geri bildiriminiz varsa Chromium hata bildiriminde bulunun.

Tarayıcıda büyük dil modelleri de dahil olmak üzere modelleri kullanan tüm yerleşik yapay zeka API'lerini keşfedin.