Claude HTTP 400: temperature 미지원 오류는 어떻게 해결하나요?

어떤 오류인가요?

Claude 요청에서 다음과 같은 오류가 발생할 수 있습니다.

HTTP 400: claude-haiku-5-5 does not support non-default temperature

오류에 top_p 또는 top_k가 표시될 수도 있습니다. 이러한 샘플링 매개변수는 무작위성이나 후보 토큰 범위를 조절합니다. 전송한 설정이 모델 또는 API 버전과 호환되지 않는다는 뜻입니다.

요청에서 temperature, top_p, top_k를 삭제하세요. 온도를 기본값으로 바꾸는 것만으로는 충분하지 않습니다.

왜 발생하나요?

• 모델 제한: Claude Haiku 5.5 등 최신 모델은 사고 기능을 꺼도 기본값이 아닌 샘플링 값을 거부합니다. 공식 샘플링 규칙을 참고하세요.
• API 버전 제한: Anthropic Messages API는 2026-10-21 버전부터 temperature: 1.0을 포함해 모든 값에 대해 이 필드들을 거부합니다. 공식 마이그레이션 가이드를 참고하세요.

규칙은 모델과 API에 따라 다르며, 모든 모델에 적용되는 온도 설정은 없습니다. OpenAI-compatible 호출에서도 지원하지 않는 필드를 삭제하세요. 이 오류를 해결하려고 anthropic-version을 추가하거나 변경하지 마세요.

해결 방법

1. 모델 또는 공급자 설정에서 사용자 지정 샘플링을 끄거나 요청 JSON에서 해당 필드를 삭제하세요. null, 빈 문자열, 기본 숫자를 보내는 것은 필드를 생략하는 것과 다릅니다.
2. SDK 래퍼, 전역 기본값, 모델 사전 설정, 상태 확인 스크립트를 확인하세요. 설정 화면뿐 아니라 실제로 전송되는 요청 본문을 확인하세요.
3. 클라이언트가 이 필드들을 요구하면 업데이트하거나 필드를 생략할 수 있는 설정을 사용하세요. 여러 모델을 사용하는 앱에서는 영향을 받는 요청만 수정하세요.
4. 설정을 저장하고 짧은 텍스트로 테스트하세요. 테스트는 실제 사용량에 따라 과금됩니다. 동일한 잘못된 매개변수로 반복 요청하지 마세요.

요청 본문 예시

이 본문에는 샘플링 필드가 없습니다. 메시지를 실제 작업으로 바꾸고 사용하는 API의 Base URL과 인증 방식을 유지하세요.

{
  "model": "claude-haiku-5-5",
  "max_tokens": 4096,
  "messages": [
    {"role": "user", "content": "Reply with only: OK"}
  ]
}

• Anthropic Messages: Base URL은 https://bettertoken.ai, 요청 경로는 /v1/messages입니다. x-api-key에 BetterToken API Key를 넣으세요.
• OpenAI Chat Completions: Base URL은 https://bettertoken.ai/v1, 요청 경로는 /chat/completions입니다. Authorization: Bearer <BETTERTOKEN_API_KEY>를 사용하세요.

공통 설정에서 샘플링 필드를 다시 추가하지 않는지 확인하세요. 원하는 형식, 길이, 어조는 프롬프트에 명시하세요.

오류가 계속되나요?

새 오류 전체를 읽고 같은 매개변수를 가리키는지 확인하세요. 지원팀에 Model ID, 클라이언트와 버전, API 경로, 시간대를 포함한 발생 시각, 요청 ID(있는 경우), 민감 정보를 제거한 요청 필드를 전달하세요. BetterToken API Key, 인증 헤더, 개인 대화는 보내지 마세요.

관련 문서

• API 오류 처리
• Base URL 설정
• Claude Haiku 5.5