ANTHROPIC 모델 가이드
Claude Sonnet 5 API
코딩, 에이전트, 문서 작업과 도구 기반 앱을 위한 Anthropic의 빠르고 성능 좋은 운영용 모델.
개발·긴 문서·도구 사용 에이전트·Sonnet 4.6에서 업그레이드하는 운영 시스템.
이전 샘플링 설정·수동 추론 예산·assistant 미리 채우기에 의존하는 연동.
선택·연동
Claude Sonnet 5 API 요금 상세
Claude Sonnet 5(claude-sonnet-5)는 토큰 사용량으로 과금합니다. 아래는 1M 토큰당 USD 요금입니다. LLMFly AI 그룹 배율 0.5x는 이미 적용됐으니 다시 곱하지 마세요. 공식 참고 요금은 별도입니다. 사이트 모델 목록 스냅샷을 사용하므로 호출 전 최신 목록과 계정 요금을 확인하세요.
예: 캐시되지 않은 입력 10,000 토큰과 출력 1,000 토큰은 LLMFly AI에서 약 $0.015입니다. 캐시 쓰기, 도구, 재시도와 기타 추가 요금은 제외됩니다.
- 플랫폼과 제공사는 입력 요금 구간이 다릅니다. 공식 장문 배율을 플랫폼 요금에 적용하지 마세요.
- 미표시는 무료가 아닙니다. 캐시 읽기·쓰기와 캐시되지 않은 입력을 각 과금 항목으로 계산하세요.
- 토큰 비용 = 각 과금 항목의 토큰 수 × 백만 토큰당 요금 ÷ 1,000,000. 도구와 기타 요금은 따로 더하세요.
| 요금 출처 | 요청당 입력 토큰 | 입력 | 출력 | 캐시 쓰기 | 캐시 읽기 | 1시간 캐시 쓰기 |
|---|---|---|---|---|---|---|
| LLMFly AI | 단일 요금 | $1 | $5 | $1.25 | $0.1 | $2 |
| 공식 참고 요금 | 단일 요금 | $2 | $10 | $2.5 | $0.2 | $4 |
Sonnet 4.6에서 전환하기 전 확인
| 이전 연동 방식 | Sonnet 5 동작 | 필요한 변경 |
|---|---|---|
| 수동 확장 추론 예산 | 미지원 | adaptive thinking + effort 사용 |
| 기본값이 아닌 temperature / top_p / top_k | 400 반환 | 설정을 제거하거나 기본값 사용 |
| assistant 메시지 미리 채우기 | 미지원 | user 메시지·명확한 형식 제약 사용 |
| 이전 토큰 예산 재사용 | 과소 추정 가능 | 토큰 재계산·max_tokens 수정 |
토큰화 변경이 예산에 미치는 영향
- 시스템 프롬프트·도구 스키마·일반 문서 토큰 재계산.
- 추론 토큰과 최종 텍스트는 출력 예산을 공유합니다.
- 잘림 비율·지연·작업당 비용 함께 확인.
- 실제 경로의 캐시·사용량 기록 검증.
adaptive thinking·effort 설정
Sonnet 5는 adaptive thinking이 기본 활성화되며 effort로 조절합니다. 기본 high에서 품질을 확인한 뒤 effort를 낮춰 지연·출력 감소가 허용되는지 시험하세요.
- 기본 문맥 1M·최대 출력 128K토큰.
- adaptive thinking은 기본 활성화되며 effort로 조절합니다.
- 지원 플랫폼의 도구·브라우저·컴퓨터 사용 도구.
- 주로 개발·AI 에이전트 흐름에 맞춘 설계.
Sonnet 5에 맞는 운영 작업
개발·에이전트가 주요 용도지만 실제 저장소·도구·실패 유형으로 검증하세요.
- 운영 코드·프런트엔드·코드 리뷰·리팩터링.
- 긴 문서 분석·지식 작업 흐름.
- 도구·브라우저·구조화 체크포인트가 필요한 에이전트.
- Sonnet 수준 지연을 유지하며 Sonnet 4.6에서 업그레이드하는 팀.
LLMFly AI로 Sonnet 5 호출
예시는 OpenAI 호환 엔드포인트를 씁니다. 모델 목록이 다른 프로토콜·경로를 제공하면 현재 키의 설정으로 도구·스트리밍·오류를 시험하세요.
curl https://app.llmfly.ai/v1/chat/completions \
-H "Authorization: Bearer $LLMFLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Summarize the tradeoffs in three bullets."}],
"stream": false
}'중단 없는 전환 체크리스트
- 실제 트래픽 전환 전 운영 샘플을 오프라인 재실행.
- 비호환 샘플링 필드·assistant 미리 채우기 제거.
- 토큰·max_tokens·시간 제한·예산 재계산.
- 400 오류·도구·구조화 출력·잘림 검증.
- 일부 트래픽으로 시험·Sonnet 4.6 복구 경로 유지.
Sonnet 5 비호환 설정
- 수동 확장 추론 예산은 제거됐습니다. adaptive thinking과 effort를 쓰세요.
- 기본값이 아닌 temperature·top_p·top_k는 400 오류를 반환합니다.
- assistant 메시지 미리 채우기는 지원하지 않습니다.
- 새 토큰화로 같은 텍스트가 Sonnet 4.6보다 약 30% 늘 수 있습니다. 입력을 재계산하고 예산을 수정하세요.
Claude Sonnet 5 사양 출처·이용 안내
전환 동작·사양은 Anthropic Claude Sonnet 5 문서로 확인했습니다: https://platform.claude.com/docs/en/models/sonnet-5/whats-new-sonnet-5. 모델 목록·작은 요청으로 선택한 LLMFly AI 경로의 프로토콜·도구 지원을 확인하세요.
자주 묻는 질문
ID만 바꿔 Sonnet 4.6을 Sonnet 5로 교체할 수 있나요?
안전한 전환은 아닙니다. 먼저 토큰화·adaptive thinking·샘플링·assistant 미리 채우기·출력 예산 차이를 처리하세요.
이전 temperature 설정이 왜 오류를 내나요?
Sonnet 5는 기본값 외 temperature·top_p·top_k에 400을 반환합니다. 제거하거나 지원 기본값을 쓰세요.
Sonnet 5는 수동 추론 예산을 지원하나요?
아니요. 수동 확장 추론 예산 대신 adaptive thinking·effort를 쓰세요.
모든 요청이 Sonnet 4.6보다 저렴한가요?
토큰 가격만으로 판단할 수 없습니다. 같은 텍스트도 토큰이 늘 수 있으니 실제 사용량을 비교하세요.
전환 위험은 어떻게 줄이나요?
오프라인 재실행·토큰 재계산·소량 트래픽 시험 후 검증된 복구 경로를 유지하세요.
실제 작업으로 Claude Sonnet 5 시험
API 키를 만들고 모델 ID를 확인한 뒤 대표적인 작은 요청으로 시작하세요.