소개
Claude Sonnet 5.5는 2026년 9월 28일에 출시된 Anthropic의 최신 Sonnet이며, Anthropic은 속도와 지능의 가장 좋은 조합이라고 설명합니다. 여기서는 /v1/chat/completions의 OpenAI 호환 엔드포인트 하나로 제공됩니다. 한 번의 요청에 텍스트를 최대 1,000,000토큰까지 담을 수 있고, 한 번의 응답은 최대 128,000토큰까지 출력할 수 있습니다.
reasoning_effort에는 none, low, medium, high, xhigh, max를 지정할 수 있으며 기본값은 medium입니다. none은 모델에게 응답 전 사고를 생략하도록 요청하지만, 긴 대화에서는 모델이 짧게 생각할 수 있습니다. 샘플링은 모델이 직접 고정하므로 temperature와 top_p는 받지 않습니다. 요청당 최대 128개의 도구를 정의할 수 있고, tool_choice는 auto 또는 none이며, 응답은 Server-Sent Events로 스트리밍됩니다.
핵심 기능 및 하이라이트
요청마다 정하는 사고량
직접 조절할 수 있는 것은 사고량입니다. none은 응답 전 사고 단계를 요청하지 않고, low와 medium은 짧게 유지하며, high, xhigh, max는 단계적으로 더 많이 생각하게 합니다. 한 줄짜리 답변과 긴 계획이 같은 연동을 거치며, 바뀌는 것은 필드 하나뿐입니다.
장면을 끝까지 이어 쓰기
플랫폼은 자체 필터를 추가하지 않습니다. 2026년 10월 1일 저희 테스트에서 모델은 다섯 단계에 걸친 콘텐츠 요청 24건을 하나도 거절하지 않았고, '매우 강함'과 '최대' 단계를 포함해 모두 전문을 썼습니다.
100만 토큰의 컨텍스트
1,000,000토큰은 영어 단어로 약 555,000개입니다. 긴 이야기 기록, 방대한 문서, 중간 규모 저장소를 요약하지 않고 그대로 보낼 수 있습니다. 필요했던 세부 사항이 빠진 재서술이 아니라, 실제로 오간 내용을 모델이 읽습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | 대화 턴을 오래된 순서로 나열합니다. role은 system, developer, user, assistant, tool이며 system과 developer 메시지는 모델의 지침이 됩니다. 1개 이상 |
max_tokens | 아니요 | 응답 상한을 설정합니다(최대 128,000, 기본값 4,096). 사고도 같은 예산에 포함되므로 상한이 작으면 화면에 보이는 답변이 끝나기 전에 추론에 소진될 수 있습니다. |
reasoning_effort | 아니요 | none, low, medium, high, xhigh, max 중 하나이며 기본값은 medium입니다. none은 응답 전에 사고하지 않도록 지시하지만(Anthropic의 |
stop | 아니요 | 정지 시퀀스를 최대 4개까지 문자열 또는 배열로 지정합니다. 모델이 그중 하나를 쓰는 즉시 응답이 끝나며, 일치한 텍스트 자체는 출력에서 빠집니다. 1자 이상 · 1개 이상 · 4개 이하 |
tools | 아니요 | 요청당 최대 128개의 함수 정의를 OpenAI function 형식으로 전달합니다. 각 정의에는 name, description, JSON 스키마 파라미터가 들어갑니다. 128개 이하 |
parallel_tool_calls | 아니요 | 기본값은 true입니다. false로 설정하면 모델이 한 턴에 도구를 최대 하나만 호출하며, 각 호출이 직전 호출의 결과에 의존하는 연쇄 작업에 알맞습니다. 기본값: |
tool_choice | 아니요 | auto 또는 none입니다. Sonnet 5.5는 도구 강제를 받지 않습니다. |
요금
입력 $2 / 출력 $10 100만 토큰당
활용 사례
인터랙티브 픽션과 롤플레이
판타지 캠페인, 미스터리, 우주선 승무원, 동반자 캐릭터 모두 같은 방식으로 다룹니다. 페르소나와 세계관 규칙은 system 메시지에 두고, 지금까지의 이야기를 순서대로 보내며, 평범한 턴에서는 reasoning_effort를 none이나 low로 하되(긴 대화에서는 모델이 짧게 생각할 수 있으므로 max_tokens는 4,000토큰 이상으로 설정하세요), 여러 복선이 만나는 장면에서 올립니다.
장편 원고의 다음 챕터
지금까지의 챕터와 개요를 순서대로 보내고 문체 규칙은 system 메시지에 적은 뒤, 다음 챕터를 요청하세요. 앞선 챕터가 그대로 전달되므로 2장에 심어 둔 디테일을 12장에서 회수할 수 있습니다.
코드베이스 전체를 대상으로 한 리뷰
저장소, 명세, 변경 사항을 한 요청에 보내고 줄을 짚어 낼 수 있는 지적을 요청하세요. 파일을 넘나드는 호출을 따라가야 하는 리뷰라면 reasoning_effort를 high로 합니다.
프롬프트 가이드 및 실전 팁
medium에서 시작해 한 단계씩 조정하기
이 모델에 대한 Anthropic의 기본값은 high이지만, 채팅과 지연 시간에 민감한 작업은 medium이나 low에서 시작하라고 권장합니다. 계획이 필요 없는 턴에는 none을 쓰되(max_tokens는 4,000토큰 이상), xhigh나 max는 틀린 답의 비용이 추가 토큰보다 클 때만 사용하세요.
max_tokens에 사고를 위한 여유 남기기
사고는 max_tokens에 포함됩니다. 기본값 4,096은 대화형 응답에 알맞습니다. 챕터, 보고서, 여러 파일에 걸친 계획이라면 읽고 싶은 길이보다 넉넉히 크게 설정하세요. 추론 단계가 높을수록 더 중요합니다.
response_format 대신 도구 호출로 요청하기
이 엔드포인트에는 response_format이 없고, tool_choice로 특정 도구를 강제할 수도 없습니다. 원하는 JSON 스키마를 파라미터로 가진 도구를 정의하고, tool_choice는 auto로 둔 채, 그 도구를 호출해 답하라고 지시한 뒤, 돌아온 인수를 검증하세요. 이 엔드포인트는 동영상과 오디오 파트를 받지 않으며, 128,000을 넘는 max_tokens는 거부됩니다.
짧고 깔끔한 답에는 none 대신 low
none은 모델에게 응답 전 사고를 생략하도록 요청하는 가장 빠른 설정이지만, 긴 대화에서는 모델이 짧게 생각할 수 있고 그 사고도 max_tokens에 포함됩니다. 또한 모델이 질문을 눈에 보이는 텍스트 안에서 먼저 따져 보는 경우도 있습니다. 짧고 깔끔한 답이 필요할 때는 low를 사용하세요. none은 빠른 캐릭터 대화 턴에 남겨 두되 max_tokens를 4,000토큰 이상으로 설정하고, 긴 응답에서는 stream을 true로 설정해 텍스트가 작성되는 대로 표시되게 하세요.
API 빠른 시작
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "anthropic/claude-sonnet-5.5/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
