자주 발생하는 문제Classic Editor 기반의 긴 게시물 번역 실패
Classic Editor 기반의 긴 게시물 번역 실패
Classic Editor 기반의 긴 게시물은 최대 토큰 수가 적은 API를 사용할 경우 번역에 실패할 수 있습니다(예: DeepSeek V3의 최대 토큰 수는 8K에 불과합니다).
그 이유는 Classic Editor가 번역 대상 HTML 콘텐츠를 하나의 덩어리로 저장하기 때문입니다. 이 문자열이 최대 토큰 수를 초과하면 요청으로 전송할 수 없게 됩니다.
이 경우 로그에 다음과 같은 오류 메시지가 표시됩니다:
🔴 ERROR [Query "translate-customposts"] Execution with errors: String to translate exceeds max length of '...': ...해결 방법으로는 다음 중 하나를 선택할 수 있습니다:
- 더 많은 최대 토큰 수를 제공하는 API 서비스로 전환하기
- Gutenberg 에디터로 전환하여 단일 HTML 콘텐츠를 여러 Gutenberg
html블록으로 마이그레이션하기(각 블록이 8000자를 초과하지 않도록 합니다)
Gutenberg 에디터 기반의 게시물은 블록으로 구성되며, 각 블록의 속성을 개별적으로 번역할 수 있습니다. 여러 문자열이 다수의 요청으로 분할되므로 게시물이 길어도 문제가 없습니다.
Prev