Claude API 400 (invalid_request_error · 잘못된 요청)
지금 장애가 있나요?
Claude API 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
Claude API의 가동 상태 보기 →오류의 의미
400은 요청이 잘못되었거나 유효하지 않다는 의미입니다. JSON 형식 오류, 필수 파라미터 누락 또는 잘못된 값, 지원되지 않는 모델 이름, 범위를 벗어난 값(예: max_tokens를 모델 허용치보다 크게 설정) 등이 원인입니다.
자주 있는 원인
- •JSON 형식 오류 또는 잘못된 Content-Type
- •필수 필드 누락 또는 이름 오기(model, messages, max_tokens)
- •유효하지 않은 모델 이름, 또는 해당 키로 접근할 수 없는 모델
- •max_tokens가 모델 최댓값을 초과하는 등 범위를 벗어난 값
- •잘못된 메시지 구조(빈 messages, 잘못된 role 순서, 너무 큰 이미지)
해결 방법
- 1.에러 메시지를 확인하세요. 문제가 된 필드명이 정확히 명시됩니다
- 2.JSON을 검증하고 Content-Type: application/json을 설정하세요
- 3.모델 이름을 최신 모델 목록과 대조하세요
- 4.max_tokens를 모델 한도 이내로 낮추세요
- 5.messages 배열을 수정하세요(비어 있지 않게, user/assistant 교대, 올바른 base64 이미지)
기다리면 되는 경우 / 기다려도 안 되는 경우
요청 측 에러이므로 기다려도 해결되지 않습니다. 에러 상세에 명시된 필드에 따라 요청 본문을 수정하세요.
Claude API을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
400 invalid_request_error은(는) 무엇인가요?
400은 요청이 잘못되었거나 유효하지 않다는 의미입니다. JSON 형식 오류, 필수 파라미터 누락 또는 잘못된 값, 지원되지 않는 모델 이름, 범위를 벗어난 값(예: max_tokens를 모델 허용치보다 크게 설정) 등이 원인입니다.
400 invalid_request_error은(는) 어떻게 해결하나요?
에러 메시지를 확인하세요. 문제가 된 필드명이 정확히 명시됩니다 / JSON을 검증하고 Content-Type: application/json을 설정하세요 / 모델 이름을 최신 모델 목록과 대조하세요 / max_tokens를 모델 한도 이내로 낮추세요 / messages 배열을 수정하세요(비어 있지 않게, user/assistant 교대, 올바른 base64 이미지)