Back to User Guide Index ご利用ガイド目次に戻る 사용 가이드 목차로 돌아가기 返回使用指南目录 User Guide ご利用ガイド 사용 가이드 使用指南

AI API 키·모델·최대 글자 수 설정

Write Buddy는 OpenAI·Anthropic(Claude)·Google 중 한 곳의 API 키를 하나만 등록하면 작동합니다. 입력한 API 키의 형식에서 사용할 AI 서비스가 자동으로 판별되므로, 보통은 키를 하나 붙여넣기만 하면 설정이 완료됩니다. 설정은 모두 WordPress 관리자 화면의 “설정” → “Write Buddy” 페이지에서 진행합니다.

각 AI 서비스 API 키 공식 문서

이용할 AI 서비스를 하나 선택하여 아래 공식 사이트에서 API 키를 발급받으세요(3개 서비스 모두 등록할 필요는 없습니다).

OpenAI(GPT): https://platform.openai.com/api-keys
Anthropic(Claude): https://console.anthropic.com/settings/keys
Google(Gemini): https://aistudio.google.com/apikey

각 서비스 모두 API 키를 발급받으려면 계정 등록과 결제 수단 등록(종량 과금용)이 필요합니다. 자세한 발급 절차는 각 서비스 사이트의 안내를 따라 주세요. 참고로 Anthropic(Claude)의 API 키를 사용하는 경우, 대표 이미지 자동 생성 기능은 이용할 수 없습니다(Anthropic은 이미지 생성 API를 제공하지 않기 때문입니다). 이미지 생성 기능도 함께 사용하고 싶다면 OpenAI 또는 Google의 API 키를 이용해 주세요.

발급받은 API 키 등록 방법

WordPress 관리자 화면의 왼쪽 메뉴에서 “설정” → “Write Buddy”를 엽니다.
“API 키” 항목에 발급받은 API 키를 그대로 붙여 넣습니다.
페이지 하단의 “변경 사항 저장”을 클릭합니다.
저장 후 화면 상단에 “현재 설정: ○○로 인식되었습니다”라는 알림이 표시되면 AI 서비스가 올바르게 자동 판별된 것입니다.

자동 판별이 잘 되지 않는 경우(수동으로 제공사 지정)

API 키 형식으로 자동 판별이 되지 않은 경우, “저장은 되었지만 어떤 AI 서비스인지 인식하지 못했습니다”라는 경고가 표시됩니다. 이 경우에는 “수동 제공사 지정” 항목에서 실제로 사용할 서비스를 직접 선택해 주세요.

자동 감지(초기값)
Anthropic(Claude)
OpenAI(GPT)
Google(Gemini)

보통은 “자동 감지”로 두어도 문제없습니다. 수동 지정이 필요한 경우는 자동 판별이 잘못되었을 때뿐입니다.

API 키 삭제

등록된 API 키가 있는 경우, “저장된 API 키 삭제” 체크박스가 표시됩니다. 체크한 뒤 저장하면 등록된 키가 삭제됩니다.

사용 모델 등록 방법

“설정” → “Write Buddy” 페이지의 “모델 설정” 항목에서 사용할 AI 모델을 이름으로 직접 입력할 수 있습니다(드롭다운이 아니라 텍스트 입력입니다). 비워 둔 경우에는 판별된 AI 서비스의 권장 모델이 자동으로 사용됩니다.

이미지 생성 모델: 대표 이미지 생성에 사용할 모델명을 입력합니다.
텍스트 모델(교정·채팅용): 문장 교정·AI 채팅·빠른 글 작성·대표 이미지 구도 검토에 사용할 모델명을 입력합니다.

비워 둔 경우에 사용되는 초기 모델(본 가이드 작성 시점의 설정)은 다음과 같습니다. 이용 중인 AI 서비스 측의 플랜·제공 상황에 따라 지정 가능한 모델명은 변경될 수 있습니다.

Anthropic(Claude): 텍스트 모델 claude-haiku-4-5(이미지 생성 모델 제공 없음)
OpenAI(GPT): 텍스트 모델 gpt-5-mini / 이미지 생성 모델 gpt-image-1-mini
Google(Gemini): 텍스트 모델 gemini-2.5-flash / 이미지 생성 모델 gemini-2.5-flash-image

특정 모델을 사용하고 싶은 경우(예: 더 높은 정확도의 상위 모델을 사용하고 싶은 경우)에는 각 AI 서비스가 제공하는 모델명을 입력란에 입력한 뒤 “변경 사항 저장”을 클릭해 주세요.

최대 글자 수 등록 방법

“모델 설정” 항목 아래에 있는 “교정에 전송할 최대 글자 수”에서 AI에 전송할 글 내용의 최대 글자 수를 설정할 수 있습니다.

초기값: 6000자
입력 가능한 최소값: 500자(100자 단위로 조정)

이 상한은 “문장 교정”뿐만 아니라 AI 채팅에 전달되는 글 내용이나 대표 이미지 생성 시 AI가 구도를 검토할 때 참고하는 글 요약에도 공통으로 적용됩니다. 글자 수를 초과한 부분은 자동으로 잘려서 전송됩니다.

또한, 빠른 글 작성 기능에서 불러오는 참고 URL·참고 파일의 글자 수에는 이 설정과는 별도의 상한(참고 자료 1건당 최대 8,000자, 합계 최대 20,000자, 참고 URL은 최대 5건까지)이 미리 설정되어 있으며 변경할 수 없습니다.

설정을 변경했다면 페이지 하단의 “변경 사항 저장”을 클릭하여 저장해 주세요.