이 문서에서는 "대기열 진행 불가, 작업 실패, 배송 실패, 비정상적인 청구"와 같은 문제를 신속하게 파악하는 데 도움이 되도록 일반적인 문제, 문제 해결 단계 및 제공되는 기술 지원 범위를 요약합니다.

I. 자주 묻는 질문 (FAQ)

1) 어떤 웹사이트와 콘텐츠 유형이 지원되나요?

이 플러그인은 WPML을 통해 관리되는 다국어 콘텐츠를 지원하며, 여기에는 WPML에서 지원하는 기사, 페이지 및 사용자 정의 콘텐츠 유형이 포함됩니다(단, 실제 사이트 구성에 따라 다를 수 있습니다).
번역 작업은 WPML 대기열의 XLIFF 작업을 기반으로 하며, 완료되면 자동으로 WPML로 다시 전달됩니다.

2) 무료 버전과 유료 버전의 주요 차이점은 무엇인가요?

무료: 기계 번역(MT)만 지원됩니다.
유료 구독: LLM 번역 지원, 프롬프트 템플릿 선택 가능(b2b / b2c / tech_doc / creative이 기능은 사용자 지정 웹사이트 프로필 프롬프트 구성을 지원하며 사용자가 구독 크레딧 소모 없이 자체 API 키를 가져올 수 있도록 합니다.

3) LLM 번역 비용은 어떻게 청구되나요? 예상보다 비용이 적거나 많은 이유는 무엇인가요?

LLM은 실제 입력/출력 토큰을 기준으로 정산되며, 비용은 선택한 모델의 단가와 연관됩니다.
이 시스템은 번역 가능한 텍스트/노드를 추출하고 유효하지 않은 콘텐츠(예: HTML 태그 및 구조)를 최소화하기 때문에 일반적으로 "전체 텍스트를 직접 번역"하는 것보다 토큰을 더 적게 절약합니다.
높은 콘텐츠 소비량은 중복 콘텐츠, 긴 단락, 표시되는 텍스트 양 또는 잦은 재시도 횟수로 인해 발생할 수 있습니다. 최종 소비량 기록이 최종 지표로 사용됩니다.

4) 작업이 실패한 이유는 무엇입니까? 실패할 경우 비용이 청구됩니까?

오류는 다음과 같은 이유로 발생할 수 있습니다.

불안정한 모델 출력, 서버 측 속도 제한/타임아웃
콘텐츠 구조가 복잡합니다(플레이스홀더, 중첩 태그, 비정상적인 인코딩).
잘못된 API 키/잔액 부족/권한 부족/지역 제한
네트워크 오류 또는 사이트 푸시백 권한 부족

실패한 작업의 경우 부분적인 비용이 발생할 수도 있으며(예: 요청이 전송되었지만 부분적인 결과가 반환된 경우), 정산은 시스템에 기록된 실제 비용을 기준으로 이루어집니다.

5) 내장 API 키를 활성화한 후에도 구독료가 계속 차감되나요?

내장 API 키를 활성화하면 번역 요청 시 내장 키가 사용되며 구독 크레딧이 소모되지 않습니다. 비용은 제3자 서비스 제공업체의 내장 키 요금에 포함됩니다.
시스템은 (정산 및 문제 해결을 위해) 작업, 상태 및 소비 내역을 계속 기록합니다.

6) 프롬프트 템플릿은 어떻게 선택해야 할까요? 사용자 지정 웹사이트 프로필 프롬프트에는 무엇을 포함해야 할까요?

b2b제품/솔루션, 기업 서비스 분야에서 전문성과 엄격함을 최우선으로 합니다.
b2c소비자 중심적이며 자연과 친화성을 중시합니다.
tech_doc기술 문서/지원 센터, 정확성 일관성
creative마케팅/크리에이티브 카피라이팅, 표현력과 스타일에 중점

맞춤 웹사이트 프로필에는 다음 사항이 포함되어야 합니다.

브랜드 어조(간결함/권위적/생동감 등)
목표 고객 및 제품 배경
용어 선호도 및 비활성화된 표현
제목/버튼/CTA 스타일 기본 설정

7) 용어집이 있습니까?

용어집 기능은 곧 출시될 예정입니다. 최종 버전은 기능 페이지 설명 및 엔진 지원 정보에 따라 결정됩니다.

II. 문제 해결 가이드 (증상을 기반으로 문제를 신속하게 찾는 방법)

증상 A: WPML 대기열에 작업이 있지만 작업 목록에 표시되지 않거나 처리되지 않습니다.

우선순위 확인 사항:

사이트 바인딩이 성공적으로 완료되었습니까?"사이트 관리"로 이동하여 상태가 정상인지 확인하십시오.
사이트 인증/키가 만료되었습니까?도메인 이름, HTTPS 또는 캐싱 전략을 변경한 경우 바인딩을 다시 확인하는 것이 좋습니다.
WPML 대기열이 정말로 "번역 대기 중" 단계에 진입했나요?작업이 대기열에 할당되었는지, 다른 번역 서비스에서 작업을 가져가지 않았는지 확인하십시오.
사이트 작업이 패키지의 사이트 제한을 초과했습니까?제한을 초과하면 작업이 인수되지 않을 수 있습니다.
시스템에 대기열 지연이 있습니까?이용량이 많은 시간대에는 대기열이 발생할 수 있습니다. 나중에 작업 상태를 새로고침해 주세요.

그래도 문제가 해결되지 않으면 문제가 발생한 작업의 시점, 작업 ID(또는 작업 제목/언어 쌍)를 내보내고 지원 티켓을 제출하세요.

증상 B: 작업에 "실패/비정상"이 표시됩니다.

확인 순서:

실패 원인을 확인하십시오"번역 작업"에서 작업 세부 정보를 열고 오류 메시지를 기록하세요.
엔진 및 권한을 확인하세요
- 무료 패키지: LLM 엔진이 선택되지 않았음을 확인했습니다.
- 내장 API 키가 포함되어 있습니다. 키의 유효성, 충분한 신용 한도 및 올바른 권한을 확인하십시오.
복잡성을 줄이고 재시도하세요
- 먼저 기계 번역을 사용하여 과정이 성공적으로 완료되었는지 확인합니다.
- LLM으로 다시 전환하고 보다 안정적인 Prompt를 사용하세요(권장).tech_doc또는b2b)
콘텐츠 구조 문제
- 콘텐츠에 플레이스홀더/숏코드/복잡한 HTML이 많이 포함된 경우, 페이지를 분할하거나 한 번에 처리할 콘텐츠 양을 줄이는 것이 좋습니다.
속도 제한/타임아웃
- 엔진/모델 교체
- 짧은 시간 안에 너무 많은 과제를 제출하지 마세요.

증상 C: 번역은 완료되었지만 WPML에 반영되지 않음 / WPML에서 결과가 표시되지 않음

주요 검사 영역:

WPML은 쓰기 응답 수신을 허용합니까?사이트 권한 및 WPML 상태는 정상인가요?
사이트 방화벽/WAF/보안 플러그인 차단이는 콜백 인터페이스가 가로채일 때 자주 발생합니다.
캐싱으로 인해 화면 표시가 지연됩니다.페이지 캐시/객체 캐시를 지운 후 다시 시도하십시오.
해당 작업이 현재 "검토 대기 중" 상태인가요?일부 WPML 프로세스는 게시하기 전에 수동 확인이 필요합니다.

증상 D: 번역 후 서식 오류/비정상적인 태그/누락된 자리 표시자가 나타납니다.

권장 조치:

전환을 우선시하세요tech_doc프롬프트 템플릿
예를 들어, 사용자 지정 웹사이트 프로필 프롬프트에 제약 조건을 추가합니다.
- "모든 자리 표시자/변수/숏코드를 변경하지 마십시오."
- HTML 태그와 속성은 번역하지 마십시오.
문제가 특정 페이지에서만 발생하는 경우, 페이지를 분할하거나 한 번에 번역하는 텍스트 블록의 크기를 줄이세요.
문제가 재현 가능한 경우, 원래 페이지 유형과 언어 쌍을 제공하고 위치 지원을 요청하십시오.

증상 E: 청구 금액이 예상과 일치하지 않음 / 신용 한도가 너무 빨리 감소함

검증 단계:

"작업 소모 세부 정보"에 해당 내용이 있는지 확인하십시오.
- 여러 번 재시도하면 추가적인 오버헤드가 발생합니다.
- 동일한 작업의 반복 실행
- 모델 출력 시간이 길어질수록 출력 토큰 수가 증가합니다.
내장 API 키가 활성화되어 있는지 확인해 주십시오(내장 키는 구독료가 발생하지 않지만, 타사 결제 비용이 증가할 수 있습니다).
이상 징후가 의심되는 경우 "작업 ID + 시간 범위 + 엔진/모델"을 제출하여 확인을 요청하십시오.

III. 제공되는 기술 지원 범위

지원되는 채널 (페이지 방문을 권장합니다)

작업 주문/이메일 지원(권장): 오류 해결, 롤백 이상 처리 및 요금 확인에 사용됩니다.
문서 및 FAQ: 일반적인 구성, 문제 해결 단계, 모범 사례

지원 가능

설치 및 바인딩 문제 해결 (사이트 확인, 권한, 콜백 실패)
큐 처리 오류/작업 실패 시 문제 해결 및 권장 사항
엔진 구성 및 프롬프트 사용 권장 사항(시나리오에 따라 선택)
거래 내역 검증 및 이상 징후 조사 (작업 기록 및 로그 기반)

지원 범위에 포함되지 않습니다 (명확히 설명해 주십시오).

WPML 설정 또는 타사 플러그인 코드를 대신 수정해 드립니다.
타사 모델 제공업체(자체 API 키 보유)와의 청구 분쟁 및 환불
사이트 보안 정책(예: 방화벽 규칙 비활성화)과 충돌하는 강제 우회입니다.

일반적인 문제 및 해결 방법 Back to list