Proofreader API

Thomas Steiner

Alexandra Klepper

Yayın tarihi: 12 Eylül 2025

Açıklayıcı	Web	Uzantılar	Chrome Durumu	Amaç
GitHub	Origin denemesi	Origin denemesi	Görünüm	Deneme Amacı (Intent to Experiment)

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 eklemektedir.

Proofreader API ile web uygulamanıza veya uzantınıza yerleşik yapay zeka sayesinde etkileşimli yazım denetimi özelliği ekleyebilirsiniz. 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 devam ederken düzeltmeler yapın.

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

Yerleşik yapay zeka API'lerinin tümü Chrome'da localhost üzerinden kullanılabilir. Aşağıdaki işaretleri Etkin olarak ayarlayın:

• chrome://flags/#optimization-guide-on-device-model
• chrome://flags/#prompt-api-for-gemini-nano-multimodal-input
• chrome://flags/#proofreader-api-for-gemini-nano

Ardından Yeniden başlat'ı tıklayın veya Chrome'u yeniden başlatın. Hatalarla karşılaşırsanız localhost ile ilgili sorunları giderin.

Kaynak denemesine 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 aracını 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. Tamamen düzeltilmiş girişi correctedInput özelliğinde, düzeltme listesini ise corrections dizisinde bulabilirsiniz:

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 Worker'lar

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 aşamada 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.