endpoint 구성
1개의 공개 endpoint를 제공합니다: message.
# Base URL
https://runapi.ai
# Endpoints
POST /v1/messages
curl https://runapi.ai/v1/messages \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "이 풀 리퀘스트를 보안 취약점, 성능 문제에 대해 검토하고 구체적인 개선 사항을 제안해 주세요."
}
]
}'import anthropic
client = anthropic.Anthropic(
base_url="https://runapi.ai",
api_key="your-runapi-key"
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "이 풀 리퀘스트를 보안 취약점, 성능 문제에 대해 검토하고 구체적인 개선 사항을 제안해 주세요."}]
)import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://runapi.ai",
apiKey: "your-runapi-key"
});
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "이 풀 리퀘스트를 보안 취약점, 성능 문제에 대해 검토하고 구체적인 개선 사항을 제안해 주세요." }]
});사용 가능한 버전 15개
개요
Claude Sonnet 5.5로 옮기면 무엇이 달라지나
Anthropic은 2026년 9월 28일에 Claude Sonnet 5.5를 출시했습니다. 입력과 출력 토큰 단가는 Sonnet 5와 같고, 2026년 10월 7일부터 캐시 읽기 요금은 Sonnet 5의 절반입니다. Anthropic은 버그 수정이나 문서 작성처럼 범위가 분명하고 완료 기준이 명확한 일상 작업용 모델로 소개하며, 정답이 정해져 있지 않은 문제에는 Opus 5.5를 권장합니다.
Sonnet 5용으로 작성한 코드는 요청을 몇 군데 고쳐야 합니다. thinking: {type: "disabled"}로 thinking을 끄면 이제 400이 반환되므로, effort가 high 이하일 때는 {type: "between_tools"}를 보내세요. tool_choice를 any 또는 특정 도구 이름으로 지정하는 강제 도구 사용도 400이 반환되므로, auto와 strict 도구 정의로 바꿔야 합니다. Sonnet 5.5는 기본값이 아닌 temperature, top_p, top_k도 거부합니다.
RunAPI에서 claude-sonnet-5-5는 Anthropic Messages 엔드포인트(/v1/messages)로만 제공됩니다. OpenAI Chat Completions, Responses, Gemini 형식으로 이 모델을 요청하면 RunAPI가 거부하므로, Anthropic SDK 또는 Claude Code에서 호출하세요.
모델 ID
claude-sonnet-5-5
출시일
2026년 9월 28일
컨텍스트 윈도우
1M 토큰
최대 출력
128K 토큰
지식 기준일
2026년 6월
기본 effort(API)
high
RunAPI 프로토콜
Anthropic Messages
Playground
Claude Sonnet 5.5 체험하기
원하는 모델을 선택하고 몇 초 만에 생성해보세요.
사양
스펙
| 제공자 | Anthropic |
| 모델 ID | claude-sonnet-5-5 |
| 모달리티 | 텍스트 |
| 작업 유형 | Synchronous |
| API 엔드포인트 | /v1/messages |
| 청구 단위 | 1K 토큰 |
| 카탈로그 상태 | 운영 중 |
사용 방법
이 모델을 3단계로 사용하기
-
키 받기
무료로 가입하고 대시보드에서 claude-sonnet-5-5용 API 키를 만드세요.
-
요청 보내기
/v1/messages로 claude-sonnet-5-5 모델 ID와 매개변수를 포함한 POST 요청을 보내세요.
-
결과 받기
엔드포인트에서 완료된 claude-sonnet-5-5 응답을 직접 읽으세요.
이 모델이 제공하는 것
사용량 기반 과금
1K 토큰 기준으로 측정되며 구독 없이 이용 가능합니다.
Claude Sonnet 5.5 요금
엔드포인트
가격
message
입력:
$1.60 / 100만 토큰
출력:
$8.00 / 100만 토큰
- 캐시 읽기: $0.08 / 100만 토큰
- 캐시 쓰기(5분): $2.00 / 100만 토큰
- 캐시 쓰기(1시간): $3.20 / 100만 토큰
API 레퍼런스
엔드포인트 사양
- 엔드포인트
- POST /v1/messages
- 모델 ID
- claude-sonnet-5-5
- 작업 유형
- message
요청 매개변수
이 엔드포인트에 게시된 요청 매개변수가 없습니다.
사용 사례
Chat
LLM을 채팅과 추론에 사용합니다.
코드
구현 작업을 생성하고 리뷰합니다.
자동화
모델을 backend 작업에 연결합니다.
사용 지표
개발자들의 선택
1
API 호출 / 일
100.0%
성공률
2.1s
평균 생성 시간
이 모델에 대한 검증된 고객 피드백이 아직 없습니다.
관련
FAQ
Claude Sonnet 5.5 자주 묻는 질문
Claude Sonnet 5.5 API 요금은 얼마인가요?
Sonnet 5.5는 입력, 출력, 캐시 쓰기, 캐시 읽기를 각각 토큰 단위로 과금하며, 이 페이지의 요금표에 RunAPI의 현재 단가가 나와 있습니다. Anthropic은 Sonnet 5의 입력과 출력 단가를 그대로 유지했고, 2026년 10월 7일에 캐시 읽기 단가를 Sonnet 5의 절반으로 낮췄습니다. 긴 컨텍스트 추가 요금은 없으므로 90만 토큰짜리 프롬프트도 짧은 프롬프트와 토큰당 단가가 같습니다.
Claude Sonnet 5.5는 Sonnet 5보다 저렴한가요?
토큰당 단가는 입력과 출력이 같고 캐시 읽기는 절반입니다. Anthropic에 따르면 Sonnet 5.5는 더 적은 토큰으로 답에 도달하기 때문에 일반적인 작업의 비용이 최대 30% 줄어듭니다. 토큰 사용량은 설정한 effort 수준에 따라 달라지므로, 큰 워크로드를 옮기기 전에 직접 보낸 요청의 usage 필드를 비교해 보세요.
Sonnet 5.5와 Opus 5.5 중 무엇을 써야 하나요?
Anthropic은 명세가 분명하고 결과를 검증할 방법이 있는 작업에는 Sonnet 5.5를, 복잡하고 정답이 열려 있는 작업에는 Opus 5.5를 권장합니다. RunAPI에서는 두 모델을 같은 API 키로 쓸 수 있어서, 모델 ID만 바꿔 작업별로 나눠 보낼 수 있습니다.
Sonnet 5.5에서는 어떤 effort 수준을 써야 하나요?
API 기본값은 high입니다. Anthropic은 명세가 분명한 에이전트 코딩과 여러 단계의 도구 사용은 medium에서 시작하고, 어려운 작업은 high로 올리며, 채팅에는 medium 또는 low를 쓸 것을 권장합니다. 수준이 높을수록 thinking 토큰을 더 많이 쓰고, thinking 토큰은 출력 단가로 과금됩니다.
Sonnet 5 코드가 Sonnet 5.5에서 400 오류를 반환하는 이유는 무엇인가요?
Sonnet 5.5는 Sonnet 5가 받아주던 세 가지 요청 형태를 거부합니다. thinking을 disabled로 설정하는 경우(effort가 high 이하면 between_tools 사용), tool_choice를 any 또는 특정 도구로 지정하는 경우(auto와 strict 도구 사용), 기본값이 아닌 temperature, top_p, top_k입니다. thinking 블록은 이를 생성한 대화에 묶여 있어서, 수정한 히스토리를 다시 보내면 실패할 수 있습니다.
요청 결과가 stop_reason refusal로 돌아온 이유는 무엇인가요?
Sonnet 5.5는 Anthropic의 안전 분류기를 실행합니다. 거부된 요청은 HTTP 200으로 반환되며 stop_reason이 refusal이고, 해당 범주를 알려 주는 stop_details 객체가 함께 옵니다. 내용을 읽기 전에 stop_reason을 먼저 확인하세요. RunAPI는 이 응답을 그대로 전달합니다.
RunAPI에서 OpenAI SDK로 Claude Sonnet 5.5를 호출할 수 있나요?
아니요. RunAPI는 claude-sonnet-5-5를 Anthropic Messages API로만 제공합니다. ANTHROPIC_BASE_URL을 https://runapi.ai로 설정한 Anthropic SDK와 RunAPI 키를 사용하거나, Claude Code 같은 Messages 클라이언트를 사용하세요.
claude-sonnet-5-5는 어떻게 선택하나요?
quickstart에 표시된 모델 ID를 전달하세요.
가격은 사용량 기반인가요?
네. 호출 또는 단위 기준으로 측정됩니다.
나중에 variant를 바꿀 수 있나요?
네. variant는 요청 매개변수입니다. model ID만 변경하면 되며 코드 변경, 재인증, 별도 청구 설정이 필요하지 않습니다. 모든 variant는 같은 API key와 요청 형식을 공유합니다.
streaming을 지원하나요?
streaming이 가능한 경우 RunAPI는 엔드투엔드로 전송합니다. LLM 모델은 token 단위 streaming을 지원하며 미디어 모델은 비동기 작업 polling 또는 webhook callback으로 결과를 전달합니다.
품질 문제는 어디에 보고하나요?
공개 GitHub repo에 issue를 열거나 [email protected]로 이메일을 보내세요. 특정 생성 결과를 조사할 수 있도록 task ID와 model ID를 포함하세요.
별도 제공사 계정이 필요한가요?
아니요. RunAPI API key만 있으면 이 variant와 카탈로그의 모든 모델에 접근할 수 있습니다. 원래 제공사의 계정은 필요하지 않습니다.