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

Prev Next

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

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

HTTP 상태 코드 코드 메시지 원인 해결 방법
400 40000 Bad request 잘못된 요청 API 명세를 확인하여 요청 구문 점검
400 40000 Each user message can contain only one image 턴당 이미지 2개 이상 포함 턴당 이미지 1개 포함으로 수정
400 40001 Invalid parameter 잘못된 요청 파라미터 파라미터의 지원 범위에 맞게 값을 조정하거나 API 요청 형식의 오류 수정
400 40003 Context length exceeded 너무 긴 요청 모델이 처리 가능한 토큰 수를 초과하지 않도록 입력된 텍스트의 길이 또는 포함한 이미지 수를 조정하거나, 파라미터에서 Maximum tokens를 낮춘 후 요청
400 40003 Image limit exceeded 요청당 이미지 최대 포함 수 초과 요청당 이미지 5개 이하로 수정
400 40004 Text empty 빈 텍스트로 요청 요청 바디에서 비어 있는 내용을 채운 후 요청
400 40005 Unavailable output 내부 정책상 결과를 제공할 수 없는 요청 -
400 40009 Unsupported function 지원하지 않는 기능 요청 요청 구문의 tuningType 지원 여부 또는 Chat Completions /Completions 지원 여부 확인
400 40009 Unsupported function 지원하지 않는 도구(tool) 요청 요청 처리가 가능한 도구를 선택 또는 요청에서 해당 도구 지원 여부 확인
400 40060 Unsupported image format 지원하지 않는 형식의 이미지 포함 BMP, PNG, JPG, JPEG, WEBP 형식의 이미지로 변경
400 40061 File size error 지원하지 않는 이미지 크기 0Byte 초과 20MB 이하 크기의 이미지로 변경
400 40063 Invalid image size 이미지 길이 초과 가로, 세로 중 긴 쪽은 2240px 이하, 짧은 쪽은 4px 이상의 이미지로 요청
400 40063 Invalid image ratio 지원하지 않는 이미지 비율 가로, 세로 비율이 1:5 또는 5:1 이하의 이미지로 변경
400 40063 Invalid image file 처리할 수 없는 이미지 정상적인 이미지 파일인지 확인 후 다시 시도
400 40063 Invalid image url 이미지를 찾을 수 없는 URL 정상적으로 이미지를 가져올 수 있는 URL 인지 확인 후 다시 시도
400 40063 Image download failed 모델이 이미지 다운로드 실패 잠시 후 다시 시도
400 40063 Image processing error 모델이 이미지 처리 실패 잠시 후 다시 시도
400 40080 Model not found 모델 찾을 수 없음 모델 이름 확인 후 요청
400 40082 Model fade out 모델 지원 종료 지원하는 모델로 변경하여 요청
400 40083 Model no resource 모델에 할당된 자원 없음 이용 신청 해지 및 계약 종료 여부 확인
400 40084 Unsupported API for model 해당 API가 지원하지 않는 모델로 요청을 보낸 경우 해당 API가 지원하는 모델로 변경하거나, 모델을 사용할 수 있는 API로 변경하여 다시 요청
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 요청 리소스 찾지 못함 요청 구문이 유효한지 확인
404 40400 File not found Object Storage 버킷에서 요청 리소스 찾지 못함 요청 구문(파일 경로)이 유효한지 확인
406 40600 Not Acceptable 잘못된 미디어 형식 미디어 형식 유효한지 확인
408 40800 Request timeout 요청 처리 시간 초과 요청 다시 시도
408 40800 Image I/O timeout 모델의 이미지 다운로드 처리 시간 초과 최대 이용량을 초과하지 않도록 요청을 제어하거나 다시 시도
413 41300 Request body size exceeded 요청 바디 크기 초과 50MB 이하로 수정 후 요청
415 41500 MediaType error 지원하지 않는 미디어 형식 미디어 형식 유효한지 확인
415 41501 No multipart boundary Content-Type multipart 사용이 필요하지만 형식에 맞지 않는 요청 multipart 사용 시 필요한 형식으로 변경하여 요청
424 42400 Processing Failed 요청 처리 중 일부 항목에 문제 발생 요청 형식의 정합성 확인 후 다시 시도
429 42900 Too many requests 너무 많은 요청 사전 고지된 이용량 제어 정책에 따라 설정된 최대 이용량을 초과하지 않도록 요청 시 응답 헤더의 관련 정보를 확인하여 최대 이용량 범위 이내로 제어하거나 Exponential backoff 등의 방식으로 재시도 처리
429 42901 Too many requests - rate exceeded 너무 많은 요청 (최대 이용량 초과) 사전 고지된 이용량 제어 정책에 따라 설정된 최대 이용량을 초과하지 않도록 요청 시 응답 헤더의 관련 정보를 확인하여 최대 이용량 범위 이내로 제어하거나 Exponential backoff 등의 방식으로 재시도 처리
429 42902 Too many requests - overloaded 너무 많은 요청(트래픽 과다) 한정된 GPU 인프라 기반의 컴퓨팅 리소스로 인해 사용자가 설정된 최대 이용량 이내로 서비스를 이용하더라도 인프라 상황 및 트래픽에 따라 처리 지연이 발생하거나 실패할 수 있음
429 42903 Too many requests - image queue 너무 많은 이미지 요청 (처리 지연) 잠시 후 다시 시도
참고

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