실패한 번역 재실행

번역이 실패하면(API가 오프라인 상태가 되거나, 잘못된 API 키를 사용하거나, 크레딧이 부족한 경우 등), 해당 항목과 언어에 대해서만 번역을 재실행하여 이미 성공한 번역에 대한 API 크레딧을 낭비하지 않을 수 있습니다.

항목/언어의 번역이 실패한 경우, 목록 페이지의 Polylang 편집 아이콘이 노란색 배경으로 강조 표시됩니다.

실패한 번역이 있는 항목만 표시하도록 필터링할 수도 있습니다(게시물 및 미디어 목록 페이지에서만 가능):

이러한 항목을 필터링하면 모든 항목에 대해 한 번에 번역을 손쉽게 재실행할 수 있습니다.

마지막으로, Gato Translate (Custom) 일괄 작업을 실행하고 Process failed translations only 옵션을 선택하여 실패한 번역을 재실행하세요.

WP-CLI를 사용하는 경우, --process-failed 매개변수를 사용하여 실패한 번역을 재실행할 수 있습니다.

팁

번역이 실패한 이유를 파악하고 싶다면 다음 방법으로 확인할 수 있습니다.

번역이 실패하면 플러그인 메뉴에 🔴 Error 알림 배지가 표시됩니다.

Logs 메뉴 항목으로 이동하여 query-execution 항목 아래에서 오류 메시지를 확인할 수 있습니다. 하나 이상의 언어에서 번역이 실패했을 수 있습니다.

이 스크린샷에서는 ChatGPT가 예상보다 적은 수의 번역을 반환하여 독일어 번역이 실패했습니다.

이 경우에는 API 엔드포인트가 오프라인 상태가 되어 모든 번역이 실패했습니다.

여기서는 여러 문제가 복합적으로 발생하여 이탈리아어와 스페인어 번역이 실패했습니다.

로그 메시지에서 실패한 언어를 파악하여 해당 언어에 대해서만 번역을 재실행하고, 불필요한 API 크레딧 소비를 방지할 수 있습니다.

실패한 번역이 콘텐츠만 업데이트한 게시물이고 이미 Replace internal links 작업을 실행한 경우, 게시물을 가리키는 링크가 깨지지 않도록 게시물 슬러그를 재번역하지 않는 것이 좋습니다.

이를 위해 사용자 정의 설정에서 Translate custom post slugs? 옵션의 체크를 해제하세요.

모델의 신뢰성이 낮아 번역이 실패한 경우, 더 나은 모델로 전환할 수 있습니다.

예를 들어, 다음과 같은 오류 메시지는:

The API for provider 'ChatGPT' returned an array with a lower number of translations than the number of strings to translate

...주로 ChatGPT-5 mini를 사용할 때 발생하며, ChatGPT-5 이상의 모델에서는 발생하지 않습니다.

번역을 재실행할 때 이러한 더 나은 모델 중 하나로 전환할 수 있습니다.