Claude Haiku 5.5 API 가격·마이그레이션｜입력 $0.10, 4.5에서 바꿀 때 400 오류 주의점

"Haiku 4.5로 돌리던 분류·요약 자동화를 5.5로 바꾸면 얼마나 싸질까?", "모델 이름만 바꾸면 그대로 돌아갈까?" API로 Claude를 쓰는 분들이 이번 주에 가장 많이 확인할 질문입니다. Anthropic은 2026년 10월 7일 Claude Haiku 5.5(모델 ID claude-haiku-5-5)를 출시했습니다.

결론부터 말하면, Haiku 5.5는 100만 토큰당 입력 $0.10·출력 $0.50으로 Haiku 4.5(입력 $1·출력 $5)보다 단가가 크게 낮습니다. 다만 한 요청의 프롬프트가 10만 토큰을 넘으면 가격이 5배로 올라가고, 4.5용 코드에 들어 있던 일부 파라미터는 400 오류를 내기 때문에 모델 이름만 바꾸는 것으로는 부족합니다.

✅ 이 글에서 얻을 수 있는 것
1. Haiku 5.5 가격표와 10만 토큰 가격 분기 계산법
2. Haiku 4.5와 비용 비교 예시
3. 4.5 → 5.5 전환 시 400 오류가 나는 항목과 코드 수정 포인트

Claude Haiku 5.5 핵심 사양

적응형 사고는 모델이 질문 난이도에 맞춰 생각하는 양을 스스로 조절하는 방식입니다. Anthropic에 따르면 Haiku 5.5는 Haiku급 모델 중 처음으로 노력(effort) 단계를 조절할 수 있습니다.

⚠️ Amazon Bedrock에서는 Haiku 5.5의 구조화된 출력(Structured Outputs)을 지원하지 않습니다. JSON 스키마 강제 출력에 의존하는 파이프라인이라면 플랫폼을 먼저 확인하세요.

Haiku 5.5 API 가격표 (100만 토큰당)

가격표에는 이 밖에 1시간 캐시 쓰기 $0.20, 배치 처리 입력 $0.05·출력 $0.25도 나와 있습니다.

10만 토큰 기준은 이렇게 판정합니다

가격 문서에 따르면 프롬프트 길이는 캐시 읽기·쓰기를 포함한 전체 입력 토큰으로 계산하고, 요청마다 따로 판정합니다. 하루 합계가 아니라 요청 한 건의 입력이 기준이라는 뜻입니다.

컨텍스트 창이 100만 토큰이라 긴 문서를 통째로 넣고 싶어지지만, 10만 토큰을 넘는 순간 그 요청의 입력·출력·캐시 단가가 모두 5배가 됩니다. 긴 문서는 필요한 부분만 잘라 넣거나 여러 요청으로 나누는 설계가 비용에 유리합니다.

Haiku 4.5와 비용 비교 예시

Haiku 4.5의 가격은 입력 $1, 출력 $5(100만 토큰당)입니다. 요청 1,000건, 건당 입력 2만 토큰·출력 1천 토큰인 요약 작업을 가정해 계산하면 다음과 같습니다(캐시 미사용).

단순 단가로는 10분의 1 수준입니다. 다만 Haiku 5.5는 적응형 사고가 기본으로 켜져 있어 응답에 thinking 블록이 포함될 수 있으므로, 실제 청구 토큰은 작업 성격에 따라 달라질 수 있습니다. 또 Haiku 5.5는 Claude 4.7 이후 모델과 같은 새 토크나이저를 써서 같은 글이 Haiku 4.5보다 약 30% 더 많은 토큰으로 계산됩니다(공식 문서 기준, 내용에 따라 다름). 위 표처럼 토큰 수를 같게 놓고 비교하면 실제보다 조금 유리하게 보이는 셈입니다. 전환 전에 같은 작업으로 소량 테스트해 보는 것이 좋습니다. Anthropic은 공식 발표에서 Haiku 5.5가 평균 약 75% 적은 비용으로 돌아간다고 밝혔는데, 이는 Anthropic 자체 수치입니다.

같은 날 Sonnet 5.5의 캐시 읽기 가격도 100만 토큰당 $0.20에서 $0.10으로 내려갔고, Claude Max와 Team 요금제에는 매월 API 크레딧이 포함되기 시작했습니다(크레딧 금액은 공식 발표에서 확인 필요).

📌 함께 보면 좋은 가이드: 챗GPT 웹/앱 구독 vs OpenAI API 차이점 및 비용 구조 — 구독과 API 과금 방식의 차이를 먼저 정리하고 싶다면

Haiku 4.5 → 5.5 마이그레이션: 400 오류 나는 항목

릴리스 노트는 Haiku 4.5용 코드가 5.5에서 깨질 수 있다고 명시합니다. 아래 항목이 요청에 남아 있으면 400 오류가 납니다.

400 오류 항목 말고도 공식 문서가 호환되지 않는 변경(breaking)으로 분류한 항목이 하나 더 있습니다. 이전 대화 턴을 바꾸면 그 대화의 thinking 블록이 무효가 됩니다. thinking 블록을 다음 요청에 다시 보내는 구조라면, 대화를 고치지 말고 뒤에 덧붙이기만(append-only) 하도록 유지하세요.

프리필은 assistant 메시지 앞부분을 미리 채워 응답 형식을 강제하는 기법입니다. 예를 들어 {를 미리 넣어 JSON으로 시작하게 만드는 방식인데, Haiku 5.5에서는 이 방식이 오류를 냅니다.

수정 전후 코드 예시 (Python)

# 수정 전: Haiku 4.5에서 쓰던 요청 (Haiku 5.5에서는 400 오류)
resp = client.messages.create(
    model="claude-haiku-4-5",
    max_tokens=2000,
    temperature=0.2,                                       # 400 원인
    thinking={"type": "enabled", "budget_tokens": 1024},   # 400 원인
    messages=[
        {"role": "user", "content": "다음 문의를 분류해 JSON으로 답해 줘: ..."},
        {"role": "assistant", "content": "{"},             # 프리필, 400 원인
    ],
)

# 수정 후: Haiku 5.5
import anthropic

client = anthropic.Anthropic()  # 환경 변수 ANTHROPIC_API_KEY 사용

resp = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=2000,
    messages=[
        {"role": "user",
         "content": "다음 문의를 분류해 JSON 객체 하나로만 답해 줘: ..."},
    ],
)

# 적응형 사고가 기본으로 켜져 있어 응답이 thinking 블록으로 시작할 수 있음
# → content[0].text 를 바로 읽지 말고 text 블록만 골라 쓴다
answer = "".join(b.text for b in resp.content if b.type == "text")
print(answer)

💡 effort 단계의 정확한 필드 이름과 값, 사고 요약을 받는 thinking.display 설정 방법은 Anthropic 공식 문서의 Haiku 5.5 항목을 확인한 뒤 적용하세요. 릴리스 노트에 따르면 thinking.display를 summarized로 두지 않으면 사고 텍스트는 생략됩니다.

응답 파싱에서 깨지는 부분

기존 코드가 resp.content[0].text처럼 첫 번째 블록을 텍스트로 가정했다면 수정이 필요합니다. Haiku 5.5는 적응형 사고가 기본이라 응답이 thinking 블록으로 시작할 수 있습니다. 위 예시처럼 type == "text" 블록만 모아 쓰는 방식으로 바꿔 두면 안전합니다.

전환 체크리스트

1. 모델 ID를 claude-haiku-5-5로 바꾼다.
2. temperature, top_p, top_k, budget_tokens, 어시스턴트 프리필을 요청에서 지운다.
3. computer_20250124 도구를 computer_toolset_20260801(Claude API·Google Cloud) 또는 computer_20251124(Bedrock)로 바꾼다.
4. 응답에서 text 블록만 골라 쓰도록 파싱 코드를 고친다.
5. thinking 블록을 다시 보낸다면 이전 대화 턴을 수정하지 않고 덧붙이기만 한다.
6. 토큰이 약 30% 더 계산되므로 max_tokens와 비용 추정을 다시 잡는다.
7. 요청 한 건의 입력이 10만 토큰을 넘는 경로가 있는지 로그로 확인한다.
8. Bedrock을 쓴다면 구조화된 출력 의존 여부를 점검한다.

📌 함께 보면 좋은 가이드: 클로드 사용량 한도 확인 방법｜세션·주간 초기화 시간과 한도 도달 시 대처법 — 앱 구독 쪽 한도가 궁금하다면

운영자 코멘트

가격표와 릴리스 노트를 함께 놓고 보면, Haiku 5.5의 핵심은 싼 단가보다 "10만 토큰 분기"와 "파라미터 정리"를 얼마나 잘 관리하느냐에 있어 보입니다. 특히 temperature 값을 습관처럼 지정해 둔 자동화 스크립트가 많을 텐데, 기본값이 아닌 값을 넣은 코드는 모델 이름만 바꾸는 순간 400을 반환합니다. 운영 중인 파이프라인이라면 한 번에 전환하기보다 일부 요청만 5.5로 보내 오류와 실제 청구 토큰을 확인한 뒤 넓히는 방법을 권합니다.

맺음말

1. Claude Haiku 5.5는 2026년 10월 7일 출시, 100만 토큰당 입력 $0.10·출력 $0.50(프롬프트 10만 토큰 이하)입니다.
2. 요청 한 건의 입력이 10만 토큰을 넘으면 입력 $0.50·출력 $2.50으로 5배가 됩니다.
3. 4.5 코드의 budget_tokens, temperature·top_p·top_k, 프리필, computer_20250124는 400 오류를 내므로 먼저 정리하세요.

공식 자료

• Claude Platform 릴리스 노트 (Anthropic, 2026-10-07)
• What's new in Claude Haiku 5.5 (Anthropic 문서)
• Claude Haiku 5.5 발표 (Anthropic, 2026-10-07)
• Claude API 가격 (Anthropic 문서, 2026년 10월 확인)

👉 다음에 읽을 글
- 챗GPT vs 제미나이 vs 클로드 비교｜GPT-6 아스트라·Gemini 3.8·Claude 5.1 성능 분석 — 모델 선택 전에 세 회사 모델을 함께 비교해 보세요.
- 구글 제미나이 API 무료 사용법｜AI 스튜디오 무료 등급 모델별 한도 — 저가 API를 비교하고 있다면 함께 보세요.