자주 발생하는 문제
자주 발생하는 문제「Operation timed out」오류

「Operation timed out」오류

AI 제공업체의 API 응답에 시간이 너무 오래 걸리면, 플러그인의 HTTP 클라이언트가 요청을 중단하고 번역이 다음과 같은 오류로 실패합니다:

2026-05-20T03:11:48+00:00 Error [Query "translate-customposts"] Execution with errors: 🔴 Translation to es_AR failed - The API for provider 'ChatGPT' returned error: cURL error 28: Operation timed out after 60000 milliseconds with 0 bytes received (see https://curl.haxx.se/libcurl/c/libcurl-errors.html) for https://api.openai.com/v1/chat/completions

중요한 부분은 cURL error 28: Operation timed out after N milliseconds 입니다. 이는 API가 응답을 완료하기 전에 플러그인에 설정된 Translation Timeout 한계에 도달했음을 의미합니다.

Translation Timeout 값 높이기

설정 페이지의 Plugin Configuration > Translation Timeout 으로 이동하여 값을 늘려 주세요.

Translation Timeout 옵션 설정
Translation Timeout 옵션 설정

값은 서버의 max_execution_timephp.ini 또는 호스팅 제어판에서 설정)보다 낮게 유지하세요. 그렇게 하면 중단된 번역이 로그에 제어된 오류를 남기며 실패하게 됩니다 — 일반적인 서버 타임아웃(HTTP 502 / 504 또는 「Maximum execution time of N seconds exceeded」 빈 페이지)이 발생하는 것을 방지할 수 있습니다.

번역이 정기적으로 타임아웃되는 경우, Translation Timeout 서버의 max_execution_time 모두 를 함께 높여 주세요.

각 요청에서 전송하는 페이로드 줄이기

보완적인 해결 방법으로, 각 요청을 짧게 만들어 더 빨리 처리되고 타임아웃에 걸릴 가능성을 낮출 수 있습니다.

Settings > Service Configuration > [AI service] 로 이동하여 Max request payload length 옵션을 적절한 문자 수로 줄여 주세요.

예를 들어, 4000 으로 설정되어 있는데도 계속 실패한다면 2000 을 시도해 보세요.

「Max request payload length」옵션 설정
「Max request payload length」옵션 설정

페이로드를 줄이면 번역이 여러 개의 작은 요청으로 분할되어 각각이 더 빠르게 처리됩니다.

PHP 서버에서 타임아웃 방지하기도 참조하세요.