Proofreader API

Thomas Steiner
Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Yayın tarihi: 12 Eylül 2025

Açıklayıcı Web Uzantılar Chrome Durumu Amaç
GitHub Geliştirici denemesi Geliştirici denemesi Geliştirici denemesi Geliştirici 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 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üzeltin.
  • 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 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 ile 145 sürümlerinde çalışan Proofreader API kaynak denemesine katılın.

Donanım gereksinimlerini inceleyin

Geliştiriciler ve Chrome'da bu API'leri kullanarak özellikleri çalıştıran kullanıcılar için aşağıdaki şartlar geçerlidir. Diğer tarayıcıların farklı işletim gereksinimleri olabilir.

Dil Algılayıcı ve Çeviri API'leri, masaüstü Chrome'da çalışır. Bu API'ler mobil cihazlarda çalışmaz.

Prompt API, Summarizer API, Writer API, Rewriter API ve Proofreader API, aşağıdaki koşullar karşılandığında Chrome'da çalışır:

  • İşletim sistemi: Windows 10 veya 11; macOS 13 ya da sonraki sürümler (Ventura ve sonrası); Linux veya Chromebook Plus cihazlarda ChromeOS (Platform 16389.0.0 ve sonraki sürümler). Android, iOS ve Chromebook Plus olmayan cihazlarda ChromeOS için Gemini Nano'yu kullanan API'ler henüz desteklenmemektedir.
  • Depolama: Chrome profilinizi içeren birimde en az 22 GB boş alan.
  • GPU veya CPU: Yerleşik modeller GPU veya CPU ile çalışabilir.
    • GPU: Kesinlikle 4 GB'tan fazla VRAM.
    • CPU: 16 GB veya daha fazla RAM ve 4 veya daha fazla CPU çekirdeği.
    • Not: Ses girişi içeren Prompt API için GPU gerekir.
  • Ağ: Sınırsız veri veya ölçülmemiş bağlantı.

Tarayıcı modeli güncellediğinde Gemini Nano'nun tam boyutu değişebilir. Mevcut boyutu belirlemek için chrome://on-device-internals adresini ziyaret edin.

localhost için destek ekleme

Yerleşik tüm yapay zeka API'leri, Chrome'da localhost üzerinde 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. Proofreader API kaynak denemesine gidin.
  2. 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.
  3. Göndermek için Kaydol'u tıklayın.
  4. Sağlanan jetonu kopyalayın ve kaynağınızdaki her katılımcı web sayfasına ekleyin veya uzantı manifestinize dahil edin.
  5. Proofreader API'yi kullanmaya başlayın.

Origin 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 tamamlanmasını bekleyin ve kullanıcıyı bilgilendirin. İndirme işlemi biraz zaman alabilir.

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

İndirme işlemini tetiklemek ve yazım denetleyicinin örneğini oluşturmak 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 Workers

Varsayılan olarak, Proofreader API yalnızca üst düzey pencerelerde ve aynı kaynaklı iFrame'lerinde 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 ve kaynak kodunu inceleyin.

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.

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