클라이언트 공통 오류 문제(4xx)
- 인쇄
- PDF
클라이언트 공통 오류 문제(4xx)
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
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 상태 코드를 참고하도록 시스템을 구성하면 안정적인 운영에 도움이 됩니다.
이 문서가 도움이 되었습니까?