---
title: 'Claude Sonnet 5.5 API: 모델 ID, 요금, 마이그레이션 | RunAPI'
description: Anthropic Messages API로 claude-sonnet-5-5 호출. 토큰별 요금, 1M 컨텍스트, effort 기본값, Sonnet 5 대비 변경점.
url: https://runapi.ai/ko/models/claude/sonnet-5-5.md
canonical: https://runapi.ai/ko/models/claude/sonnet-5-5
locale: ko
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
en: https://runapi.ai/models/claude/sonnet-5-5
zh-CN: https://runapi.ai/zh-CN/models/claude/sonnet-5-5
es: https://runapi.ai/es/models/claude/sonnet-5-5
ja: https://runapi.ai/ja/models/claude/sonnet-5-5
de: https://runapi.ai/de/models/claude/sonnet-5-5
fr: https://runapi.ai/fr/models/claude/sonnet-5-5
pt-BR: https://runapi.ai/pt-BR/models/claude/sonnet-5-5
ko: https://runapi.ai/ko/models/claude/sonnet-5-5
it: https://runapi.ai/it/models/claude/sonnet-5-5
nl: https://runapi.ai/nl/models/claude/sonnet-5-5
pl: https://runapi.ai/pl/models/claude/sonnet-5-5
tr: https://runapi.ai/tr/models/claude/sonnet-5-5
zh-TW: https://runapi.ai/zh-TW/models/claude/sonnet-5-5
zh-HK: https://runapi.ai/zh-HK/models/claude/sonnet-5-5
ar: https://runapi.ai/ar/models/claude/sonnet-5-5
x-default: https://runapi.ai/models/claude/sonnet-5-5
model: Claude
provider: Anthropic
variant_id: claude-sonnet-5-5
sdk_model_id: claude-sonnet-5-5
modality: text
billing_unit: 1K 토큰
status: active
---
> HTML version: https://runapi.ai/ko/models/claude/sonnet-5-5
> Site index for agents: https://runapi.ai/llms.txt
# claude-sonnet-5-5 API
RunAPI로 Claude 패밀리의 claude-sonnet-5-5를 호출하세요. 토큰당 요금, 구독 없음, 응답이 시작되기 전에 실패한 요청은 과금되지 않습니다.
**Anthropic / [Claude](https://runapi.ai/ko/models/claude.md)**
**운영 중 · text · 상업적 사용 지원**
## 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
## Claude Sonnet 5.5 체험하기
원하는 모델을 선택하고 몇 초 만에 생성해보세요.
**모델:**
- **Message** — `message` · `claude-sonnet-5-5` · 입력 $1.60 / 100만 토큰 | 출력 $8.00 / 100만 토큰
**프롬프트:** 만들고 싶은 것을 설명하세요...
**예상 금액:** 입력 $1.60 / 100만 토큰 | 출력 $8.00 / 100만 토큰
- [생성](https://runapi.ai/ko/login)
RunAPI로 생성하려면 로그인하세요.
### 변형 전환
- [claude-fable-5](https://runapi.ai/ko/models/claude/fable-5.md)
- [claude-fable-5-1](https://runapi.ai/ko/models/claude/fable-5-1.md)
- [claude-haiku-4-5-20251001](https://runapi.ai/ko/models/claude/haiku-4-5-20251001.md)
- [claude-haiku-5-5](https://runapi.ai/ko/models/claude/haiku-5-5.md)
- [claude-opus-4-1-20250805](https://runapi.ai/ko/models/claude/opus-4-1-20250805.md)
- [claude-opus-4-5-20251101](https://runapi.ai/ko/models/claude/opus-4-5-20251101.md)
- [claude-opus-4-6](https://runapi.ai/ko/models/claude/opus-4-6.md)
- [claude-opus-4-7](https://runapi.ai/ko/models/claude/opus-4-7.md)
- [claude-opus-4-8](https://runapi.ai/ko/models/claude/opus-4-8.md)
- [claude-opus-5](https://runapi.ai/ko/models/claude/opus-5.md)
- [claude-opus-5-5](https://runapi.ai/ko/models/claude/opus-5-5.md)
- [claude-sonnet-4-5-20250929](https://runapi.ai/ko/models/claude/sonnet-4-5-20250929.md)
- [claude-sonnet-4-6](https://runapi.ai/ko/models/claude/sonnet-4-6.md)
- [claude-sonnet-5](https://runapi.ai/ko/models/claude/sonnet-5.md)
- **claude-sonnet-5-5** (current)
사용 가능한 버전 15개
claude-sonnet-5-5는 RunAPI에서 제공하는 Claude 패밀리 모델 중 하나입니다. 다른 모델과 같은 API key를 사용하며, 요청의 모델 ID만 바꾸면 전환됩니다. 각 호출은 동기식이고 입력, 출력, 캐시 토큰 기준으로 USD로 과금되며 구독이나 최소 사용액이 없습니다. 응답이 시작되기 전에 실패한 요청은 과금되지 않습니다. 스트리밍이 시작된 뒤에는 클라이언트 연결이 끊겨도 이미 생성된 토큰이 과금됩니다.
- 구독 없이 USD 토큰당 과금
- 응답 시작 전에 실패한 요청은 과금 없음
- 토큰 단위 스트리밍
- 모델 ID 하나만 바꿔 모델 전환
- 모든 모델과 공급자에 API key 하나, 청구서 하나
## 사용 지표
- **API 호출 / 일:** 1
- **성공률:** 100.0%
- **평균 생성 시간:** 2.1s
이 모델에 대한 검증된 고객 피드백이 아직 없습니다.
## 스펙
| 필드 | 값 |
|---|---|
| 제공자 | Anthropic |
| 모델 ID | claude-sonnet-5-5 |
| 모달리티 | 텍스트 |
| 작업 유형 | Synchronous |
| API 엔드포인트 | `/v1/messages` |
| 청구 단위 | 1K 토큰 |
| 카탈로그 상태 | 운영 중 |
**사용 방법**
## 이 모델을 3단계로 사용하기
1. **키 받기** - 무료로 가입하고 대시보드에서 claude-sonnet-5-5용 API 키를 만드세요.
2. **요청 보내기** - /v1/messages로 claude-sonnet-5-5 모델 ID와 매개변수를 포함한 POST 요청을 보내세요.
3. **결과 받기** - 엔드포인트에서 완료된 claude-sonnet-5-5 응답을 직접 읽으세요.
## 이 모델이 제공하는 것
- **endpoint 구성** — 1개의 공개 endpoint를 제공합니다: message.
- **사용량 기반 과금** — 1K 토큰 기준으로 측정되며 구독 없이 이용 가능합니다.
## Claude Sonnet 5.5 요금
| 엔드포인트 | 가격 |
|---|---|
| `message` | 입력: $1.60 / 100만 토큰
출력: $8.00 / 100만 토큰
캐시 읽기: $0.08 / 100만 토큰
캐시 쓰기(5분): $2.00 / 100만 토큰
캐시 쓰기(1시간): $3.20 / 100만 토큰 |
**API 레퍼런스**
## 엔드포인트 사양
| Field | Value |
|---|---|
| 엔드포인트 | `POST /v1/messages` |
| 모델 ID | `claude-sonnet-5-5` |
| 작업 유형 | `message` |
## 요청 매개변수
이 엔드포인트에 게시된 요청 매개변수가 없습니다.
**Request example**
```json
{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{
"role": "user",
"content": "이 풀 리퀘스트를 보안 취약점, 성능 문제에 대해 검토하고 구체적인 개선 사항을 제안해 주세요."
}
]
}
```
### 모델 스킬 — claude-sonnet-5-5
스킬을 한 번 설치한 후, 이 페이지의 변형 ID를 사용해 개발을 시작하세요.
Base URL: `https://runapi.ai`
| Endpoint | Protocol |
|---|---|
| `POST /v1/messages` | Anthropic compatible |
RunAPI API key와 `model: "claude-sonnet-5-5"`를 지정해 Anthropic SDK를 사용하세요.
### claude-sonnet-5-5 사용 방법
1. **설치** — Claude 라인용 model skill을 설치하세요. 문서, 요청 형식, 가격 안내가 코딩 작업 공간에 로드됩니다.
2. **설정** — SDK가 https://runapi.ai 를 가리키도록 하고 RunAPI API key를 설정하세요. 같은 key로 모든 모델과 공급자를 사용할 수 있습니다.
3. **호출** — 이 모델이 지원하는 API 형식으로 요청을 보내고, model 필드에 이 페이지의 모델 ID를 지정하세요. RunAPI가 공급자에게 전달합니다.
4. **수신** — 같은 호출에서 응답을 읽거나 생성되는 대로 스트리밍으로 받으세요. usage 필드에서 과금되는 토큰을 확인할 수 있습니다.
### claude-sonnet-5-5 비교
- **VS CLAUDE-FABLE-5: 1M 컨텍스트; 일상적인 코딩과 에이전트 작업을 위한 Sonnet 5 후속 모델** — Mythos급 1M 컨텍스트; 코딩, 추론, 비전 최첨단
- **VS CLAUDE-FABLE-5-1: 1M 컨텍스트; 일상적인 코딩과 에이전트 작업을 위한 Sonnet 5 후속 모델** — 1M 컨텍스트; Fable 5 후속
- **VS CLAUDE-HAIKU-4-5-20251001: 1M 컨텍스트; 일상적인 코딩과 에이전트 작업을 위한 Sonnet 5 후속 모델** — 재현 가능한 출력을 위한 Haiku 4.5 날짜 고정 스냅샷
## 사용 사례
**Chat**
LLM을 채팅과 추론에 사용합니다.
**코드**
구현 작업을 생성하고 리뷰합니다.
**자동화**
모델을 backend 작업에 연결합니다.
## 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를 열거나 contact@runapi.ai로 이메일을 보내세요. 특정 생성 결과를 조사할 수 있도록 task ID와 model ID를 포함하세요.
### 별도 제공사 계정이 필요한가요?
아니요. RunAPI API key만 있으면 이 variant와 카탈로그의 모든 모델에 접근할 수 있습니다. 원래 제공사의 계정은 필요하지 않습니다.
### 관련
- [claude-haiku-5-5](https://runapi.ai/ko/models/claude/haiku-5-5.md) — Anthropic 제공 · 입력 $0.08-$0.40 / 100만 토큰 | 출력 $0.40-$2.00 / 100만 토큰
- [claude-haiku-4-5-20251001](https://runapi.ai/ko/models/claude/haiku-4-5-20251001.md) — Anthropic 제공 · 입력 $0.80 / 100만 토큰 | 출력 $4.00 / 100만 토큰
- [claude-sonnet-5](https://runapi.ai/ko/models/claude/sonnet-5.md) — Anthropic 제공 · 입력 $1.60 / 100만 토큰 | 출력 $8.00 / 100만 토큰
- [claude-sonnet-4-5-20250929](https://runapi.ai/ko/models/claude/sonnet-4-5-20250929.md) — Anthropic 제공 · 입력 $2.40 / 100만 토큰 | 출력 $12.00 / 100만 토큰
### 오늘 Claude로 시작하세요.
- [무료 계정 만들기](https://runapi.ai/ko/login)
- [빠른 시작 읽기 →](https://runapi.ai/ko/docs/api/anthropic/messages)
## 팀과 함께 구축하고 계신가요?
엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.
[문의하기](https://runapi.ai/ko/contact.md)
---
## More from RunAPI
- [Home](https://runapi.ai/ko/.md)
### 제품
- [모델 카탈로그](https://runapi.ai/ko/models.md)
- [요금](https://runapi.ai/ko/pricing.md)
- [제공사](https://runapi.ai/ko/models#all-models)
### 개발자
- [문서](https://runapi.ai/ko/docs/guides)
- [SDK](https://runapi.ai/ko/sdk.md)
- [CLI](https://runapi.ai/ko/cli.md)
- [MCP Server](https://runapi.ai/ko/mcp.md)
- [x402](https://runapi.ai/ko/x402.md)
### 가이드
- [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md)
- [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md)
- [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md)
### 회사
- [엔터프라이즈](https://runapi.ai/ko/contact.md)
- [문의](https://runapi.ai/ko/contact.md)
### 법적 고지
- [약관](https://runapi.ai/ko/terms.md)
- [개인정보](https://runapi.ai/ko/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)
Contact: contact@runapi.ai
## Structured data
```json
[
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "WebSite",
"name": "RunAPI",
"url": "https://runapi.ai/ko",
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}"
},
"query-input": "required name=search_term_string"
}
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "Organization",
"name": "RunAPI",
"url": "https://runapi.ai/ko",
"logo": {
"@type": "ImageObject",
"url": "https://runapi.ai/koicon.svg"
},
"sameAs": [
"https://github.com/runapi-ai"
]
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "SoftwareApplication",
"name": "Claude claude-sonnet-5-5",
"applicationCategory": "DeveloperApplication"
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://runapi.ai/ko"
},
{
"@type": "ListItem",
"position": 2,
"name": "Models",
"item": "https://runapi.ai/ko/models"
},
{
"@type": "ListItem",
"position": 3,
"name": "Claude",
"item": "https://runapi.ai/ko/models/claude"
},
{
"@type": "ListItem",
"position": 4,
"name": "claude-sonnet-5-5",
"item": "https://runapi.ai/ko/models/claude/sonnet-5-5"
}
]
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "HowTo",
"name": "claude-sonnet-5-5 사용 방법",
"description": "RunAPI로 Claude 패밀리의 claude-sonnet-5-5를 호출하세요. 토큰당 요금, 모델 ID, 지원하는 API 형식, 설정 가이드를 제공합니다.",
"totalTime": "PT5M",
"step": [
{
"@type": "HowToStep",
"position": 1,
"name": "설치",
"text": "Claude 라인용 model skill을 설치하세요. 문서, 요청 형식, 가격 안내가 코딩 작업 공간에 로드됩니다.",
"url": "https://runapi.ai/ko/models/claude/sonnet-5-5#how-step-1"
},
{
"@type": "HowToStep",
"position": 2,
"name": "설정",
"text": "SDK가 https://runapi.ai 를 가리키도록 하고 RunAPI API key를 설정하세요. 같은 key로 모든 모델과 공급자를 사용할 수 있습니다.",
"url": "https://runapi.ai/ko/models/claude/sonnet-5-5#how-step-2"
},
{
"@type": "HowToStep",
"position": 3,
"name": "호출",
"text": "이 모델이 지원하는 API 형식으로 요청을 보내고, model 필드에 이 페이지의 모델 ID를 지정하세요. RunAPI가 공급자에게 전달합니다.",
"url": "https://runapi.ai/ko/models/claude/sonnet-5-5#how-step-3"
},
{
"@type": "HowToStep",
"position": 4,
"name": "수신",
"text": "같은 호출에서 응답을 읽거나 생성되는 대로 스트리밍으로 받으세요. usage 필드에서 과금되는 토큰을 확인할 수 있습니다.",
"url": "https://runapi.ai/ko/models/claude/sonnet-5-5#how-step-4"
}
]
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "Claude Sonnet 5.5 API 요금은 얼마인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sonnet 5.5는 입력, 출력, 캐시 쓰기, 캐시 읽기를 각각 토큰 단위로 과금하며, 이 페이지의 요금표에 RunAPI의 현재 단가가 나와 있습니다. Anthropic은 Sonnet 5의 입력과 출력 단가를 그대로 유지했고, 2026년 10월 7일에 캐시 읽기 단가를 Sonnet 5의 절반으로 낮췄습니다. 긴 컨텍스트 추가 요금은 없으므로 90만 토큰짜리 프롬프트도 짧은 프롬프트와 토큰당 단가가 같습니다."
}
},
{
"@type": "Question",
"name": "Claude Sonnet 5.5는 Sonnet 5보다 저렴한가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "토큰당 단가는 입력과 출력이 같고 캐시 읽기는 절반입니다. Anthropic에 따르면 Sonnet 5.5는 더 적은 토큰으로 답에 도달하기 때문에 일반적인 작업의 비용이 최대 30% 줄어듭니다. 토큰 사용량은 설정한 effort 수준에 따라 달라지므로, 큰 워크로드를 옮기기 전에 직접 보낸 요청의 usage 필드를 비교해 보세요."
}
},
{
"@type": "Question",
"name": "Sonnet 5.5와 Opus 5.5 중 무엇을 써야 하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Anthropic은 명세가 분명하고 결과를 검증할 방법이 있는 작업에는 Sonnet 5.5를, 복잡하고 정답이 열려 있는 작업에는 Opus 5.5를 권장합니다. RunAPI에서는 두 모델을 같은 API 키로 쓸 수 있어서, 모델 ID만 바꿔 작업별로 나눠 보낼 수 있습니다."
}
},
{
"@type": "Question",
"name": "Sonnet 5.5에서는 어떤 effort 수준을 써야 하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "API 기본값은 high입니다. Anthropic은 명세가 분명한 에이전트 코딩과 여러 단계의 도구 사용은 medium에서 시작하고, 어려운 작업은 high로 올리며, 채팅에는 medium 또는 low를 쓸 것을 권장합니다. 수준이 높을수록 thinking 토큰을 더 많이 쓰고, thinking 토큰은 출력 단가로 과금됩니다."
}
},
{
"@type": "Question",
"name": "Sonnet 5 코드가 Sonnet 5.5에서 400 오류를 반환하는 이유는 무엇인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sonnet 5.5는 Sonnet 5가 받아주던 세 가지 요청 형태를 거부합니다. thinking을 disabled로 설정하는 경우(effort가 high 이하면 between_tools 사용), tool_choice를 any 또는 특정 도구로 지정하는 경우(auto와 strict 도구 사용), 기본값이 아닌 temperature, top_p, top_k입니다. thinking 블록은 이를 생성한 대화에 묶여 있어서, 수정한 히스토리를 다시 보내면 실패할 수 있습니다."
}
},
{
"@type": "Question",
"name": "요청 결과가 stop_reason refusal로 돌아온 이유는 무엇인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sonnet 5.5는 Anthropic의 안전 분류기를 실행합니다. 거부된 요청은 HTTP 200으로 반환되며 stop_reason이 refusal이고, 해당 범주를 알려 주는 stop_details 객체가 함께 옵니다. 내용을 읽기 전에 stop_reason을 먼저 확인하세요. RunAPI는 이 응답을 그대로 전달합니다."
}
},
{
"@type": "Question",
"name": "RunAPI에서 OpenAI SDK로 Claude Sonnet 5.5를 호출할 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "아니요. RunAPI는 claude-sonnet-5-5를 Anthropic Messages API로만 제공합니다. ANTHROPIC_BASE_URL을 https://runapi.ai로 설정한 Anthropic SDK와 RunAPI 키를 사용하거나, Claude Code 같은 Messages 클라이언트를 사용하세요."
}
},
{
"@type": "Question",
"name": "claude-sonnet-5-5는 어떻게 선택하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "quickstart에 표시된 모델 ID를 전달하세요."
}
},
{
"@type": "Question",
"name": "가격은 사용량 기반인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "네. 호출 또는 단위 기준으로 측정됩니다."
}
},
{
"@type": "Question",
"name": "나중에 variant를 바꿀 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "네. variant는 요청 매개변수입니다. model ID만 변경하면 되며 코드 변경, 재인증, 별도 청구 설정이 필요하지 않습니다. 모든 variant는 같은 API key와 요청 형식을 공유합니다."
}
},
{
"@type": "Question",
"name": "streaming을 지원하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "streaming이 가능한 경우 RunAPI는 엔드투엔드로 전송합니다. LLM 모델은 token 단위 streaming을 지원하며 미디어 모델은 비동기 작업 polling 또는 webhook callback으로 결과를 전달합니다."
}
},
{
"@type": "Question",
"name": "품질 문제는 어디에 보고하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "공개 GitHub repo에 issue를 열거나 contact@runapi.ai로 이메일을 보내세요. 특정 생성 결과를 조사할 수 있도록 task ID와 model ID를 포함하세요."
}
},
{
"@type": "Question",
"name": "별도 제공사 계정이 필요한가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "아니요. RunAPI API key만 있으면 이 variant와 카탈로그의 모든 모델에 접근할 수 있습니다. 원래 제공사의 계정은 필요하지 않습니다."
}
}
]
}
]
```