문제 해결
자동화 동작 실행 후 오류 발생
섹션 제목: “자동화 동작 실행 후 오류 발생”전역 작업 오버레이를 펼쳐 전체 오류를 확인합니다.
실패한 작업은 평소처럼 다시 시도할 수 있습니다. 작업이 오랫동안 진행되지 않고 실행 중 또는 대기 중 상태로 남아 있다면 강제 재시도를 사용하세요.
구체적인 오류 메시지를 읽은 다음 아래의 문제 해결 섹션을 확인하세요.
문제를 해결할 수 없다면 개발자에게 문의하세요.
요청 시간 초과
섹션 제목: “요청 시간 초과”보통 네트워크가 불안정하거나 제공업체 서비스를 일시적으로 사용할 수 없다는 뜻입니다. 다음을 시도해 보세요.
- 네트워크 연결이 안정적인지 확인합니다.
- 잠시 후 다시 시도합니다.
401 오류
섹션 제목: “401 오류”오류는 다음과 같은 형태일 수 있습니다.
API returned status 401: {"error":{"message":"Authentication Fails, Your api key: ****u2sd is invalid","type":"authentication_error","param":null,"code":"invalid_request_error"}}API 키가 유효하지 않다는 뜻입니다. 다음을 확인하세요.
- API 키를 빠짐없이 복사했고 불필요한 공백이 없는지
- 제공업체와 API URL이 일치하는지
429 오류
섹션 제목: “429 오류”보통 제공업체의 요청 제한이나 과도한 동시 요청 때문입니다. 다음을 시도해 보세요.
- 누락된 항목을 직접 다시 시도합니다.
- 속도 제한 설정을 조정합니다(제공업체 문서 참고).
- 동시 요청 수를 낮춥니다.
- 요청 간격을 늘립니다.
곧바로 모든 항목을 선택해 다시 처리하지 마세요. 제공업체의 요청 제한이 더 심해져 상황이 악화될 수 있습니다.
400 오류
섹션 제목: “400 오류”API 요청이 잘못되었다는 뜻입니다. 원인이 다양하므로 오류 내용을 살펴보세요.
오류가 다음과 같다면:
API returned status 400: {"error":{"message":"The supported API model names are deepseek-v4-pro or deepseek-v4-flash, but you passed deepseek-v4-pro1111.","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}모델 식별자가 잘못되었습니다. 다음을 확인하세요.
- 식별자를 잘못 입력하지 않았는지 확인합니다. 모델 표시 이름이 아니라 제공업체가 제공하는 식별자를 사용하세요.
- 제공업체가 해당 모델을 더 이상 지원하지 않아 제거했을 수 있습니다. 이 경우 다른 모델을 사용해 보세요.
오류가 다음과 같다면:
API returned status 400: {"error":{"message":"Failed to deserialize the JSON body into the target type: messages[0]: unknown variant `image_url`, expected `text` at line 1 column 3061412","type":"invalid_request_error","param":null,"code":"invalid_request_error"}}서비스를 구성할 때 모델에 잘못된 기능이 지정되었을 수 있습니다. 예를 들면 다음과 같습니다.
- 비전 모델이 아닌 모델에 비전 관련 작업이 지정되었습니다.
“Expected X translations but got Y”
섹션 제목: ““Expected X translations but got Y””예:
Expected 6 translations but got 7. The AI likely returned malformed content, pleasetry again.시스템 프롬프트의 요구대로 모델이 항목마다 번역을 하나씩 제공하지 않았다는 뜻입니다. 다음과 같이 할 수 있습니다.
- 모델 구성을 편집해 추론 강도를 높입니다.
- 다른 모델로 바꿉니다.
- 나중에 같은 모델로 다시 시도합니다.
이 문제가 자주 발생한다면 해당 모델이 지시를 안정적으로 따르지 못해 이 작업에 적합하지 않을 수 있습니다.
제공업체 선택 페이지가 로드되지 않음
섹션 제목: “제공업체 선택 페이지가 로드되지 않음”네트워크를 사용할 수 없는 상태일 수 있습니다. 기기가 Neko Translator 메인 사이트에 연결되는지 확인하세요.
네트워크 문제를 해결할 수 없다면 수동 추가를 사용해 원하는 제공업체를 구성하세요.
텍스트 블록이 감지되지 않거나 원문이 추출되지 않음
섹션 제목: “텍스트 블록이 감지되지 않거나 원문이 추출되지 않음”- 원본 언어가 올바르게 설정되어 있는지 확인합니다.
- 이미지가 선명한지, 텍스트가 너무 작거나 기울어지거나 가려지거나 배경과 섞여 있지 않은지 확인합니다.
- 다른 감지 서비스를 사용해 봅니다.
- 손글씨, 효과음, 장식용 글꼴은 인식하기 어려울 수 있습니다. 텍스트 블록을 직접 추가하고 원문을 입력하세요.
번역 동작이 비활성화됨
섹션 제목: “번역 동작이 비활성화됨”번역하려면 원문이 있는 텍스트 블록이 하나 이상 있어야 하고, 번역 기능이 구성된 모델이 있어야 합니다.
원문이 비어 있다면 먼저 텍스트 추출을 실행하거나 텍스트를 직접 입력하세요.
번역 오류 해결 방법
섹션 제목: “번역 오류 해결 방법”다음 순서대로 확인하세요.
- 텍스트 블록이 의도한 영역을 덮고 있는지 확인합니다.
- 추출된 원문이 올바른지 확인합니다. 올바르지 않다면 더 성능이 좋은 비전 모델로 다시 인식하거나 원문을 직접 입력합니다.
- 이미지 요약을 삭제하고 다시 번역해 봅니다. 잘못된 요약이 번역 모델을 오도할 수 있습니다.
- 더 성능이 좋은 모델을 사용해 봅니다.
ZIP을 가져올 때 파일 이름이 깨짐
섹션 제목: “ZIP을 가져올 때 파일 이름이 깨짐”앱에서 파일 이름 인코딩을 선택하라는 안내가 나오면 인코딩을 선택하고 이름 미리보기를 확인하세요. 이름이 올바르게 표시되고 디코딩 오류나 중복 이름이 없을 때만 계속하세요.
작업 공간이 열리지 않음
섹션 제목: “작업 공간이 열리지 않음”작업 공간이 열리지 않으면 인터페이스에 표시되는 문제 해결 단계를 따르세요. 문제가 계속되면 개발자에게 도움을 요청하세요.
로컬 모델 다운로드 또는 가져오기 실패
섹션 제목: “로컬 모델 다운로드 또는 가져오기 실패”- 디스크 공간과 네트워크 접근을 확인합니다.
- ZIP 가져오기나 해시 검증이 실패했다면 보통 압축 파일이 불완전하거나 변조되었다는 뜻입니다.