Proofreader API

Thomas Steiner

Alexandra Klepper

게시일: 2025년 9월 4일

설명	웹	확장 프로그램	Chrome 상태	의도
GitHub	오리진 트라이얼	오리진 트라이얼	View	의도에서 프로토타입으로

교정은 문법, 맞춤법, 구두점의 오류를 찾아 수정하는 과정입니다. 브라우저와 운영체제에서는 Google Docs와 같은 작성 도구에 교정 기능을 제공하는 경우가 늘고 있습니다.

교정기 API를 사용하면 내장된 AI를 통해 웹 애플리케이션 또는 확장 프로그램에 대화형 교정을 제공할 수 있습니다. 이 API는 다음 기능을 제공합니다.

• 수정: 문법, 맞춤법, 구두점에 대한 사용자 입력을 수정합니다.
• 라벨: 오류 유형별로 각 수정사항에 라벨을 지정합니다.
• 설명: 오류가 무엇인지 또는 올바른 대답이 필요한 이유를 쉬운 언어로 설명합니다.

사용 사례

맞춤법 검사기 API를 사용해야 하는 이유는 여러 가지가 있습니다. 예를 들면 다음과 같습니다.

• 게시물을 제출하기 전에 포럼 메시지, 기사에 대한 댓글, 이메일의 수정사항을 제안합니다.
• 활성 메모 작성 중에 수정사항을 제공합니다.

사용 사례가 누락되었나요? 사전 체험 프로그램에 참여하여 의견을 공유하세요.

시작하기

Chrome 141~145에서 실행되는 Proofreader API 오리진 트라이얼에 참여하세요.

localhost 지원 추가

오리진 트라이얼 중에 localhost에서 Proofreader API에 액세스하려면 Chrome을 최신 버전으로 업데이트해야 합니다. 그런 다음 아래 단계를 따르세요.

1. chrome://flags/#proofreader-api-for-gemini-nano 페이지로 이동합니다.
2. 사용 설정됨을 선택합니다.
3. 다시 시작을 클릭하거나 Chrome을 다시 시작합니다.

오리진 트라이얼 신청

교정기 API를 사용하려면 다음 단계를 따르세요.

1. Google 생성형 AI에 관한 금지된 사용 정책을 확인합니다.
2. 맞춤법 검사기 API 오리진 트라이얼로 이동합니다.
3. 등록을 클릭하고 양식을 작성합니다. 웹 출처 필드에 출처 또는 확장 프로그램 ID(chrome-extension://YOUR_EXTENSION_ID)를 입력합니다.
4. 제출하려면 등록을 클릭합니다.
5. 제공된 토큰을 복사하여 참여하는 원본의 모든 웹페이지에 추가하거나 확장 프로그램 매니페스트에 포함합니다.
   • 확장 프로그램을 빌드하는 경우 확장 프로그램 오리진 트라이얼 안내를 따르세요.
6. Proofreader API 사용을 시작합니다.

오리진 트라이얼을 시작하는 방법을 자세히 알아보세요.

교정 도구 API 사용

모델을 사용할 준비가 되었는지 확인하려면 Proofreader.availability()를 호출합니다. availability()에 대한 응답이 "downloadable"인 경우 다운로드 진행 상황을 수신 대기하고 사용자에게 알립니다. 다운로드에 시간이 걸릴 수 있기 때문입니다.

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

다운로드를 트리거하고 맞춤법 검사기를 인스턴스화하려면 사용자 활성화를 확인하세요. 그런 다음 비동기 Proofreader.create() 함수를 호출합니다.

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

교정기 객체 만들기

교정 도구를 만들려면 Proofreader.create() 함수를 사용하세요.

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

create() 메서드에는 다음 옵션이 포함됩니다.

• expectedInputLanguages: 예상되는 입력 언어의 배열입니다.

설명자의 includeCorrectionTypes 및 includeCorrectionExplanation 옵션은 지원되지 않습니다.

사용자 텍스트 교정 시작

proofread()를 호출하여 입력 텍스트의 수정사항을 가져옵니다.

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

수정은 ProofreadResult 유형입니다. corrected 속성에서 완전히 수정된 입력을 찾고 corrections 배열에서 수정 목록을 찾습니다.

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

권한 정책, iframe, 웹 워커

기본적으로 맞춤법 검사기 API는 최상위 창과 동일한 출처 iframe에서만 사용할 수 있습니다. 권한 정책 allow="" 속성을 사용하여 API에 대한 액세스 권한을 교차 출처 iframe에 위임할 수 있습니다.

<!--
  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>

교정 도구 API는 웹 워커에서 사용할 수 없습니다. 이는 권한 정책 상태를 확인하기 위해 각 작업자에 대한 책임 문서를 설정하는 것이 복잡하기 때문입니다.

데모

교정 도구 API 플레이그라운드를 사용해 보세요.

참여 및 의견 공유

Proofreader API는 현재 활발히 논의되고 있으며 향후 변경될 수 있습니다. 이 API를 사용해 보고 의견이 있으면 언제든지 알려주세요.

• 설명 읽기, 질문하기, 토론에 참여하기
• Chrome 상태에서 Chrome 구현을 검토하세요.
• Mozilla 표준 입장과 WebKit 표준 입장을 읽어보세요.
• 사전 체험 프로그램에 참여하여 새로운 API를 미리 살펴보고 메일링 리스트에 액세스하세요.
• Chrome 구현에 관한 의견이 있으면 Chromium 버그를 신고하세요.

브라우저에서 대규모 언어 모델을 비롯한 모델을 사용하는 모든 내장 AI API를 살펴보세요.