클라이언트 공통 오류 문제(4xx)

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

CLOVA Studio 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

HTTP 상태 코드 코드 메시지 원인 해결 방법
400 40000 Bad request 잘못된 요청 API 명세를 확인하여 요청 구문 점검
400 40001 Invalid parameter 잘못된 요청 파라미터 파라미터의 지원 범위에 맞게 값을 조정하거나 API 요청 형식의 오류 수정
400 40003 Text too long 너무 긴 요청 텍스트 모델이 처리 가능한 토큰 수를 초과하지 않도록 입력된 텍스트의 길이를 줄이거나, 파라미터에서 Maximum tokens를 낮춘 후 요청
400 40004 Text empty 빈 텍스트로 요청 요청 바디에서 비어 있는 내용을 채운 후 요청
400 40005 Unavailable output 1 내부 정책상 결과를 제공할 수 없는 요청 -
400 40006 Unavailable output 2 내부 정책상 결과를 제공할 수 없는 요청 -
400 40009 Unsupported function 지원하지 않는 기능 요청 요청 구문의 tuningType 지원 여부 또는 Chat Completions /Completions 지원 여부 확인
400 40080 model not found 모델 찾을 수 없음 모델 이름 확인 후 요청
400 40082 model fade out 모델 지원 종료 지원하는 모델로 변경하여 요청
401 40100 Unauthorized 인증 실패 작업의 생성자와 요청자의 권한 확인
401 40101 Invalid signature 유효하지 않은 요청 서명 유효한 Client ID, ClientSecret 값으로 액세스 토큰 재발급
401 40102 Invalid access token 유효하지 않은 액세스 토큰 유효한 Client ID, ClientSecret 값으로 액세스 토큰 재발급
401 40103 Access token expired 액세스 토큰 만료 액세스 토큰 확인 재발급
401 40104 Invalid key 유효하지 않은 인증 키 유효한 Client ID, ClientSecret 값으로 액세스 토큰 재발급
401 40170 No subscription request history found. Please request a subscription to use CLOVA Studio 이용 신청 이력을 찾을 수 없음 네이버 클라우드 플랫폼 콘솔에서 CLOVA Studio 서비스의 이용 신청 여부 확인
403 40300 Forbidden 서버 작업 거부 요청 기능에 대한 사용 권한 소유 여부 확인
403 40301 No ownership 소유권 없음 요청 기능에 대한 사용 권한 소유 여부 확인
404 40400 Not found 요청 리소스 찾지 못함 요청 구문이 유효한지 확인
406 40600 Not Acceptable 잘못된 미디어 형식 미디어 형식 유효한지 확인
408 40800 Request timeout 요청 처리 시간 초과 요청 다시 시도
415 41500 MediaType error 지원하지 않는 미디어 형식 미디어 형식 유효한지 확인
415 41501 No multipart boundary Content-Type multipart 사용이 필요하지만 형식에 맞지 않는 요청 multipart 사용 시 필요한 형식으로 변경하여 요청
429 42900 Too many requests 너무 많은 요청 사전 고지된 이용량 제어 정책에 따라 설정된 최대 이용량을 초과하지 않도록 요청 시 응답 헤더의 관련 정보를 확인하여 최대 이용량 범위 이내로 제어하거나 Exponential backoff 등의 방식으로 재시도 처리
429 42901 Too many requests - rate exceeded 너무 많은 요청 (최대 이용량 초과) 사전 고지된 이용량 제어 정책에 따라 설정된 최대 이용량을 초과하지 않도록 요청 시 응답 헤더의 관련 정보를 확인하여 최대 이용량 범위 이내로 제어하거나 Exponential backoff 등의 방식으로 재시도 처리
429 42902 Too many requests - overloaded 너무 많은 요청(트래픽 과다): 한정된 GPU 인프라 기반의 컴퓨팅 리소스로 인해 사용자가 설정된 최대 이용량 이내로 서비스를 이용하더라도 인프라 상황 및 트래픽에 따라 처리 지연이 발생하거나 실패할 수 있음 -
참고

HTTP 상태 코드를 참고하도록 시스템을 구성하면 안정적인 운영에 도움이 됩니다.