Rewriter API

Alexandra Klepper

Thomas Steiner

게시일: 2025년 5월 20일

설명 동영상	웹	확장 프로그램	Chrome 상태	인텐트
	Origin 무료 체험	Origin 무료 체험	View	실험 의도

Rewriter API를 사용하면 텍스트를 수정하고 재구성할 수 있습니다. 이 API와 Writer API는 Writing Assistance API 제안서의 일부입니다.

이러한 API를 사용하면 사용자가 만든 콘텐츠를 개선하는 데 도움이 됩니다.

사용 사례

기존 텍스트를 더 길게 또는 더 짧게 만들거나 어조를 변경하여 수정합니다. 예를 들어 다음과 같은 작업을 할 수 있습니다.

• 더 정중하고 격식 있는 어조로 짧은 이메일을 다시 작성합니다.
• 다른 고객이 의견을 이해하거나 유해성을 제거하는 데 도움이 되도록 고객 리뷰에 수정을 제안합니다.
• 특정 시청자의 기대에 맞게 콘텐츠 형식을 지정합니다.

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

시작하기

Chrome 137~142에서 실행되는 Rewriter API 오리진 트라이얼에 참여하세요.

오리진 트라이얼 가입

Rewriter API는 Writer API와 공동 오리진 트라이얼에서 사용할 수 있습니다. 이러한 API를 사용하려면 다음 단계를 따르세요.

1. Google의 생성형 AI 금지된 사용 정책을 확인합니다.
2. Rewriter API 출처 체험판으로 이동합니다.
3. 등록을 클릭하고 양식을 작성합니다. 웹 출처 필드에 출처 또는 확장 프로그램 ID chrome-extension://YOUR_EXTENSION_ID를 입력합니다.
4. 제출하려면 등록을 클릭합니다.
5. 제공된 토큰을 복사하여 출처의 참여 웹페이지마다 추가하거나 확장 프로그램 매니페스트에 포함합니다.
6. Rewriter API 사용을 시작합니다.

출처 무료 체험을 시작하는 방법을 자세히 알아보세요.

localhost에 지원 추가

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

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

Rewriter API 사용

먼저 기능 감지를 실행하여 브라우저에서 이러한 API를 지원하는지 확인합니다.

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

Rewriter API 및 기타 모든 내장 AI API는 브라우저에 통합되어 있습니다. Gemini Nano는 웹사이트에서 내장 AI API를 처음 사용하는 경우에 별도로 다운로드됩니다. 실제로 사용자가 이미 내장 API와 상호작용한 경우 모델을 브라우저에 다운로드한 것입니다.

모델을 사용할 준비가 되었는지 확인하려면 비동기 Rewriter.availability() 함수를 호출합니다. 다음 4가지 값을 사용할 수 있는 문자열을 반환합니다.

• unavailable: 브라우저에서 Rewriter API를 지원하지만 현재 사용할 수 없습니다. 모델을 다운로드할 디스크 공간이 부족한 등 여러 가지 이유로 발생할 수 있습니다.
• available: 브라우저에서 Rewriter API를 지원하며 즉시 사용할 수 있습니다.
• downloadable: 브라우저가 Rewriter API를 지원하지만 먼저 모델을 다운로드해야 합니다.
• downloading: 브라우저가 Rewriter API를 지원하며 현재 모델을 다운로드하고 있습니다.

모델 다운로드를 트리거하고 리라이터를 시작하려면 Rewriter.create() 함수를 호출합니다. availability()에 대한 응답이 downloadable인 경우 다운로드에 시간이 걸릴 수 있으므로 다운로드 진행률을 수신 대기하고 사용자에게 알립니다.

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

API 함수

create() 함수를 사용하면 새 재작성기 객체를 구성할 수 있습니다. 다음 매개변수를 사용하여 선택적 options 객체를 사용합니다.

• tone: 글의 어조는 콘텐츠의 스타일, 캐릭터 또는 태도를 나타낼 수 있습니다. 값은 more-formal, as-is (기본값) 또는 more-casual로 설정할 수 있습니다.
• format: 허용되는 값은 as-is (기본값), markdown, plain-text인 출력 형식입니다.
• length: 허용되는 값은 shorter, as-is (기본값), longer이며 출력의 길이입니다.
• sharedContext: 여러 콘텐츠를 재작성할 때 공유 컨텍스트를 사용하면 모델이 사용자의 기대에 더 부합하는 콘텐츠를 만들 수 있습니다.

다음 예는 rewriter 객체를 시작하는 방법을 보여줍니다.

const options = {
  sharedContext: 'This is an email to acquaintances about an upcoming event.',
  tone: 'more-casual',
  format: 'plain-text',
  length: 'shorter',
};

const available = await Rewriter.availability();
let rewriter;
if (available === 'unavailable') {
  // The Rewriter API isn't usable.
  return;
}
if (available === 'available') {
  // The Rewriter API can be used immediately .
  rewriter = await Rewriter.create(options);
} else {
  // The Rewriter can be used after the model is downloaded.
  rewriter = await Rewriter.create(options);
  rewriter.addEventListener('downloadprogress', (e) => {
    console.log(e.loaded, e.total);
  });
}

재작성 시작

모델에서 콘텐츠를 출력하는 방법에는 스트리밍이 아닌 방법과 스트리밍 방법이 있습니다.

비스트리밍 출력

비스트리밍 재작성에서는 모델이 입력을 전체적으로 처리한 후 출력을 생성합니다.

스트리밍이 아닌 출력을 가져오려면 비동기 rewrite() 함수를 호출합니다. 재작성하려는 초기 텍스트를 포함해야 합니다. 선택적 context를 추가하여 모델 배경 정보를 제공할 수 있습니다. 이렇게 하면 모델이 출력에 대한 기대치를 더 잘 충족하는 데 도움이 될 수 있습니다.

// Non-
const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});
const result = await rewriter.rewrite(reviewEl.textContent, {
  context: "Avoid any toxic language and be as constructive as possible."
});

스트림 재작성 출력

스트리밍은 실시간으로 결과를 제공합니다. 입력이 추가되고 조정되면 출력이 지속적으로 업데이트됩니다.

스트리밍 리라이터를 가져오려면 rewrite() 함수를 호출하고 스트림에서 사용 가능한 텍스트 세그먼트를 반복합니다. 선택사항인 context를 추가하여 모델 배경 정보를 제공할 수 있습니다. 이렇게 하면 모델이 출력에 대한 기대치를 더 잘 충족하는 데 도움이 될 수 있습니다.

const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});

const stream = rewriter.rewrite(reviewEl.textContent, {
  context: "Avoid any toxic language and be as constructive as possible.",
  tone: "more-casual",
});

for await (const chunk of stream) {
  composeTextbox.append(chunk);
}

여러 작업의 컨텍스트 공유

rewriter를 사용하여 여러 콘텐츠를 생성할 수 있습니다. 이 경우 sharedContext를 추가하면 유용합니다. 예를 들어 검토자가 댓글에서 더 나은 의견을 제공할 수 있도록 지원할 수 있습니다.

// Shared context and per writing task context
const rewriter = await Rewriter.create({
  sharedContext: "This is for publishing on [popular website name], a business and employment-focused social media platform."
});

const stream = rewriter.rewrite(
  "Love all this work on generative AI at Google! 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.",
    tone: "more-casual",
  }
);

for await (const chunk of stream) {
  composeTextbox.append(chunk);
}

재작성 도구 재사용

동일한 리라이터로 여러 콘텐츠를 수정할 수 있습니다. 이는 작성자가 생산적이고 유용한 의견을 제공할 수 있도록 피드백 또는 댓글 도구에 리라이터 도구를 추가하는 경우에 특히 유용합니다.

// Reusing a rewriter
const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});

const rewrittenReviews = await Promise.all(
  Array.from(
    document.querySelectorAll("#reviews > .review"),
    (reviewEl) => rewriter.rewrite(reviewEl.textContent, {
      context: "Avoid any toxic language and be as constructive as possible.",
      tone: "more-casual",
    })
  ),
);

재작성 도구 중지

재작성 프로세스를 종료하려면 컨트롤러를 중단하고 rewriter를 소멸합니다.

// Stop a rewriter
const controller = new AbortController();
stopButton.onclick = () => controller.abort();

const rewriter = await Rewriter.create({ signal: controller.signal });
await rewriter.rewrite(reviewEl.textContent, { signal: controller.signal });

// Destroy a rewriter
rewriter.destroy();

데모

참여 및 의견 공유

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

• 설명 자료 읽기, 질문하기, 토론 참여하기
• Chrome 상태에서 Chrome 구현을 검토합니다.
• 사전 미리보기 프로그램에 가입하여 새로운 API를 미리 살펴보고 메일링 목록에 액세스하세요.
• Chrome 구현에 관한 의견이 있으면 Chromium 버그를 신고하세요.

브라우저에서 Gemini Nano 및 기타 전문가 모델을 비롯한 모델을 사용하는 모든 기본 제공 AI API를 살펴보세요.