DeepL API에서 가장 흔히 발생하는 오류 코드에 대해 알아보세요. 더 자세한 정보는 DeepL API 문서(영어 제공)를 참조하세요.
오류 코드
오류 400
Bad request. Please check error message and your parameters
이 오류는 요청에 필수 매개변수가 누락되었거나, 지정된 매개변수 중 하나가 지원되지 않거나, 철자가 틀리거나, 값이 잘못된 경우에 발생합니다.
오류 403
Authorization failed. Please supply a valid auth_key parameter
이 오류는 요청에 API 키가 누락되었거나 잘못된 경우 발생합니다.
API 키가 유효하려면 구독이 활성화되어 있어야 합니다. DeepL 계정의 'API 키'에서 API 키와 구독 상태를 확인할 수 있습니다.
필요한 사용량에 적합한 구독 플랜을 선택했는지 확인하십시오. DeepL API에 액세스하려면 DeepL API 플랜을 구독해야 합니다. ‘플랜 및 가격 페이지’를 방문하여 CAT 툴용 인증 키가 포함된 플랜을 확인하십시오.
오류 404
The requested resource could not be found
이 오류는 URL이 잘못되었을 때 발생합니다. URL의 경로를 확인해 주세요.
오류 413
The request size exceeds the limit
이 오류는 요청 크기가 지원되는 한도에 도달했을 때 발생합니다.
크기 제한, 특히 파일 번역에 대한 자세한 정보는 API 기술문서를 참조하십시오.
단일 번역 요청으로 대용량 텍스트를 번역하려는 경우, 예를 들어 단락별로 나누어 여러 요청으로 분할하는 것을 고려해 보십시오.
오류 414
Request-URL Too Long
이 오류는 API URL이 너무 길 때 발생하며, 웹 서버의 길이 제한으로 인해 발생합니다. GET 요청 대신 POST 요청을 사용하면 이 오류 메시지를 피할 수 있습니다.
오류 429
Too many requests. Please wait and resend your request
이 응답을 받으면 잠시 기다렸다가 다시 시도하십시오. 동일한 오류가 다시 발생하면 재시도 간격을 더 길게(예: 대기 시간을 두 배로 늘림) 해 보십시오. 요청이 성공할 때까지 이 과정을 반복하십시오. 그런 다음 대기 시간을 다시 점차 줄여 나갈 수 있습니다.
단일 요청에서 전송하는 텍스트 양을 줄이면 이 오류가 발생할 가능성을 줄일 수 있습니다.
오류 456
Quota exceeded. The character limit has been reached
이 오류는 글자 수 한도에 도달했을 때 발생합니다. DeepL 계정의 비용 관리 설정을 확인하고 필요한 경우 한도를 늘리십시오.
오류 5**
Internal error
5로 시작하는 모든 오류는 내부 오류입니다. 오류 503이 발생하면 잠시 기다렸다가 나중에 다시 시도해 보세요. 그 외의 오류가 발생하면 DeepL 지원팀에 문의하세요.