OpenAI API 400 (invalid_request_error / context_length_exceeded · 잘못된 요청)
지금 장애가 있나요?
OpenAI API 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
OpenAI API의 가동 상태 보기 →오류의 의미
400은 요청이 유효하지 않다는 의미입니다. 가장 흔한 경우는 context_length_exceeded로, messages와 max_tokens의 합이 모델의 컨텍스트 윈도를 초과한 상황입니다. 그 밖에 JSON 형식 오류, 필수 파라미터 누락 또는 잘못된 값, 지원되지 않는 모델 등이 원인입니다.
자주 있는 원인
- •context_length_exceeded: 입력과 max_tokens의 합이 모델 컨텍스트 윈도를 초과
- •JSON 형식 오류 또는 잘못된 Content-Type
- •필수 파라미터 누락 또는 잘못된 값(model, messages)
- •지원되지 않는 모델 이름, 또는 해당 모델에서 지원되지 않는 파라미터
- •잘못된 값(예: temperature 범위 초과, 잘못된 tool 스키마)
해결 방법
- 1.입력을 줄이거나 max_tokens를 낮춰 컨텍스트 윈도에 맞추세요
- 2.실제로 더 많은 토큰이 필요하다면 컨텍스트가 더 큰 모델로 전환하세요
- 3.에러 메시지를 확인하세요. 파라미터와 한도를 알려줍니다
- 4.JSON과 필수 필드를 검증하고 Content-Type: application/json을 설정하세요
- 5.선택한 모델에서 해당 파라미터가 지원되는지 확인하세요
기다리면 되는 경우 / 기다려도 안 되는 경우
요청 측 에러이므로 기다려도 해결되지 않습니다. 토큰을 줄이거나 에러에 명시된 파라미터를 수정하세요.
OpenAI API을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
400 invalid_request_error은(는) 무엇인가요?
400은 요청이 유효하지 않다는 의미입니다. 가장 흔한 경우는 context_length_exceeded로, messages와 max_tokens의 합이 모델의 컨텍스트 윈도를 초과한 상황입니다. 그 밖에 JSON 형식 오류, 필수 파라미터 누락 또는 잘못된 값, 지원되지 않는 모델 등이 원인입니다.
400 invalid_request_error은(는) 어떻게 해결하나요?
입력을 줄이거나 max_tokens를 낮춰 컨텍스트 윈도에 맞추세요 / 실제로 더 많은 토큰이 필요하다면 컨텍스트가 더 큰 모델로 전환하세요 / 에러 메시지를 확인하세요. 파라미터와 한도를 알려줍니다 / JSON과 필수 필드를 검증하고 Content-Type: application/json을 설정하세요 / 선택한 모델에서 해당 파라미터가 지원되는지 확인하세요