---
title: "클라이언트 공통 오류 문제(4xx)"
slug: "clovastudio-troubleshoot-c4xx"
updated: 2026-04-23T08:55:44Z
published: 2026-04-23T09:02:20Z
canonical: "api.ncloud-docs.com/clovastudio-troubleshoot-c4xx"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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 | `40002` | `Unsupported parameter` | 지원하지 않는 요청 파라미터 | 오픈AI 호환성을 지원하지 않는 파라미터를 제외하는 등의 조정을 통해 수정 |
| 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 | `40055` | `Invalid response format schema` | 지원하지 않는 형식의 응답 스키마 | 지원하는 형식의 응답 스키마로 변경 |
| 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로 요청 |
| 401 | `40100` | `Unauthorized` | 인증 실패 | CLOVA Studio 서비스의 인증 방식에 알맞은 인증 정보 확인 또는 서비스 앱 등록 여부 확인 |
| 401 | `40101` | `Invalid signature` | 유효하지 않은 요청 서명 | 유효한 NCP IAM Key, Secret으로 서명 재생성 |
| 401 | `40102` | `Invalid Authentication Type` | 유효하지 않은 인증 방식 | CLOVA Studio에서 유효한 인증 방식으로 재요청 |
| 401 | `40104` | `Invalid key` | 유효하지 않은 인증 키 | 유효한 API 키 확인 후 재요청 |
| 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` | 너무 많은 요청 | 사전 고지된 [이용량 제어 정책](https://guide.ncloud-docs.com/docs/clovastudio-ratelimiting)에 따라 설정된 최대 이용량을 초과하지 않도록 요청 시 응답 헤더의 관련 정보를 확인하여 최대 이용량 범위 이내로 제어하거나 Exponential backoff 등의 방식으로 재시도 처리 |
| 429 | `42901` | `Too many requests - rate exceeded` | 너무 많은 요청 (최대 이용량 초과) | 사전 고지된 [이용량 제어 정책](https://guide.ncloud-docs.com/docs/clovastudio-ratelimiting)에 따라 설정된 최대 이용량을 초과하지 않도록 요청 시 응답 헤더의 관련 정보를 확인하여 최대 이용량 범위 이내로 제어하거나 Exponential backoff 등의 방식으로 재시도 처리 |
| 429 | `42902` | `Too many requests - overloaded` | 너무 많은 요청 (트래픽 과다) | : 한정된 GPU 인프라 기반의 컴퓨팅 리소스로 인해 사용자가 설정된 최대 이용량 이내로 서비스를 이용하더라도 인프라 상황 및 트래픽에 따라 처리 지연이 발생하거나 실패할 수 있음 |
| 429 | `42903` | `Too many requests - image queue` | 너무 많은 이미지 요청 (처리 지연) | 잠시 후 다시 시도 |

          참고

          

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