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

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	`40009`	`Unsupported input format`	모델이 요청한 인풋 타입을 처리할 수 없는 경우	요청한 인풋 타입을 처리할 수 있는 모델로 변경하거나, 요청을 수정
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 상태 코드

코드

메시지

원인

해결 방법

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

40009

Unsupported input format

모델이 요청한 인풋 타입을 처리할 수 없는 경우

요청한 인풋 타입을 처리할 수 있는 모델로 변경하거나, 요청을 수정

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

너무 많은 요청 (최대 이용량 초과)

429

42902

Too many requests - overloaded

너무 많은 요청 (트래픽 과다)

: 한정된 GPU 인프라 기반의 컴퓨팅 리소스로 인해 사용자가 설정된 최대 이용량 이내로 서비스를 이용하더라도 인프라 상황 및 트래픽에 따라 처리 지연이 발생하거나 실패할 수 있음

429

42903

Too many requests - image queue

너무 많은 이미지 요청 (처리 지연)

잠시 후 다시 시도

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

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

What's Next