Claude Fable 5.2 API는 코딩 어시스턴트, 리서치 워크플로, 지속적인 다단계 작업이 필요한 애플리케이션에 고급 추론 기능을 추가할 수 있게 해줍니다. 모델 접근과 통합 방식을 어떻게 관리할지에 따라 Anthropic에 직접 연결하거나 CometAPI를 사용할 수 있습니다.
토큰 비용을 낮추고 다중 모델 통합을 단순화하려면 CometAPI를 통한 Claude Fable 5.2 API가 실용적인 시작점입니다. 공개된 입력/출력 요율이 Anthropic 표준 API 요율 대비 20% 낮고, Anthropic Messages 요청 포맷을 유지하면서 공유된 모델 접근 및 청구 워크플로 안에 둘 수 있습니다. 제공자별 계정 제어나 네이티브 기능이 핵심 요구사항이라면 Anthropic 직접 접근을 선택하세요.
이 가이드는 두 경로를 모두 다룬 뒤, Python 요청, 스트리밍, 대화 기록, 이미지 입력, 프로덕션 점검을 순서대로 설명합니다. Python 3.10 이상, 선택한 경로의 API 키, 그리고 claude-fable-5-2 접근 권한이 필요합니다.
핵심 요점
Claude Fable 5.2 API는 여기 소개된 두 경로에서 모두 모델 ID로 claude-fable-5-2를 사용합니다.
Anthropic 직접 접근과 CometAPI는 키와 과금이 분리됩니다. 요청을 보내기 전에 경로를 선택하세요.
CometAPI는 공유 자격 증명·청구·호환 API 인터페이스를 통해 다중 제공자 애플리케이션에 적합합니다.
텍스트 요청 하나로 시작한 뒤, 필요에 따라 추론 설정, 스트리밍, 대화 기록, 이미지 입력을 추가하세요.
CometAPI는 아래의 공식 표준 요율과 비교했을 때, 명시된 캐시 작업을 포함해 Claude Fable 5.2 토큰 요금을 20% 낮춥니다.
Claude Fable 5.2 API란?
Claude Fable 5.2는 까다로운 기술 작업을 위한 Anthropic의 추론 모델입니다. 2026년 11월 9일 출시되었습니다. API는 모델 인프라를 직접 운영하지 않고도 애플리케이션에서 모델에 접근할 수 있게 해줍니다.
일반적인 시작 프로젝트로는 저장소 변경 검토, 문서 모음 분석, 복잡한 시스템 설계 설명이 있습니다. 각 프로젝트는 요청과 응답으로 시작합니다. 도구와 더 긴 대화 루프는 이 경로가 작동한 뒤에 따라올 수 있습니다.
Claude Fable 5.2 API 사양
사양
Claude Fable 5.2 공식 사양
모델 ID
claude-fable-5-2
컨텍스트 윈도우
1M tokens
최대 출력
128K tokens
입력 / 출력
텍스트 및 이미지 / 텍스트
Thinking
Adaptive; 항상 활성화
API 기본 effort
high
본 가이드의 기본 요청 포맷
Anthropic Messages
컨텍스트와 출력 한도는 용량을 설명하며 권장 요청 크기를 의미하지 않습니다. 자격 증명과 응답 처리를 검증하는 동안에는 짧은 프롬프트와 적당한 출력 예산을 사용하세요.
Claude Fable 5.2 API는 Fable 5.1과 무엇이 다른가?
이미 Fable 5.1을 사용 중이라면, 업그레이드는 주로 더 나은 작업 성능, 더 낮은 표준 토큰 가격, 대화 및 도구 호환성 변경에 관한 것입니다. 아래 비교는 이전 세대로서 Fable 5.1을 기준으로 합니다.
까다로운 기술 작업에서 더 강한 결과
Anthropic의 출시 평가에 따르면, Fable 5.2는 xhigh effort에서 Fable 5.1의 32.4% 대비 FrontierCode 2.0에서 49.1%를 기록했습니다. Chartography 점수는 44.8%에서 73.4%로 상승했습니다. 또한 Anthropic은 5.1 대비 최대 30% 빠른 출력 생성을 보고하며, 선택 가능한 fast 모드를 제공합니다. 이는 벤더가 보고한 결과이며, 더 빠른 생성이 작업 전체에 걸친 요청 시간을 반드시 단축한다는 의미는 아닙니다.
저장소 리뷰나 어려운 문서 분석 작업의 경우, 새 모델이 현재 모델이 놓치는 오류를 잡는지 테스트하세요. 프롬프트, 입력, 채점 기준을 일관되게 유지하여 실용적인 질문에 답하게 하세요: 실제 작업을 더 많이 성공적으로 완료하는가?
Fable 5.1보다 낮은 표준 가격
Anthropic의 공개 표준 요율은 백만 입력 토큰당 $10에서 $8로, 백만 출력 토큰당 $50에서 $40으로, 캐시 읽기는 $0.25에서 $0.20으로 낮아졌습니다. 각각 20% 인하입니다. 이는 공식적인 세대 간 가격이며, 이후의 CometAPI 비교는 접근 제공자 간의 별도 차이를 측정합니다.
사용량이 변하지 않고 입력 토큰 100,000, 출력 토큰 10,000인 경우, 캐시를 사용하지 않은 표준 요청 비용은 Fable 5.1의 $1.50에서 Fable 5.2의 $1.20으로 감소합니다. 실제 절감액은 생성된 토큰, 재시도, 캐싱, 선택 모드에 따라 달라집니다.
모든 계정에서 대화 검사가 적용됩니다. 이전 메시지, 시스템 지시문, 도구를 편집한 후 thinking을 재생성하면 실패할 수 있으며, 이전에는 통과했던 구형 계정도 포함됩니다.
롤백이 모든 reasoning을 보존하지 않습니다. Fable 5.2와 Mythos 5.2만 Fable 5.2의 thinking 블록을 읽을 수 있습니다. 5.1 또는 다른 모델로 전환하면 해당 reasoning이 폐기될 수 있습니다.
컴퓨터 사용에는 더 새로운 도구 세트가 필요합니다. 이전 computer_20251124 도구는 Amazon Bedrock 외부에서 실패합니다. computer_toolset_20260801을 사용하고 도구 루프를 조정하세요.
Advisor 호환성 변경. Fable 5.2 executor는 Fable 5.2 또는 Mythos 5.2 advisor를 필요로 합니다.
변하지 않는 것
Fable 5.1 사양에는 이미 1M 토큰 컨텍스트 윈도우, 128K 최대 출력, 텍스트 및 이미지 입력, 항상 켜져 있는 adaptive thinking, 높은 기본 API effort가 포함되어 있습니다. 이는 5.2에서도 유용하게 유지되지만, 마이그레이션의 새로운 이유는 아닙니다.
Claude Fable 5.2 API로 어떻게 마이그레이션할까—그리고 그럴 가치가 있을까?
측정 가능하고 되돌릴 수 있는 작은 마이그레이션으로 시작하세요. 첫 요청의 성공은 시작일 뿐입니다. 애플리케이션은 대화 상태를 보존하고, 도구 워크플로를 완료하며, 폴백을 올바르게 처리해야 합니다.
CometAPI는 여러 API 포맷 전반에서 공유 키와 청구 레이어를 문서화합니다. 여러 모델 통합을 유지 관리하는 팀에게는 운영해야 하는 개별 자격 증명과 계정 워크플로의 수를 줄일 수 있습니다. Claude가 더 넓은 제품의 일부인 경우 이 이점은 커집니다.
또한 기존 Anthropic SDK 통합을 유지할 수 있습니다. 아래의 클라이언트 구성은 키와 base URL을 변경하지만, Messages 요청 본문은 그대로 유지됩니다. 이미 호환 가능한 채팅 인터페이스를 사용하는 애플리케이션에는 CometAPI가 또 다른 진입점을 제공합니다. 애플리케이션에 필요한 기능을 보존하는 포맷을 선택하세요.
계정 및 키별 사용량 리포팅은 소비량을 통합해서 조정할 공통 지점을 제공합니다. 서로 다른 제품 기능이 서로 다른 모델을 사용할 때 결합된 지출을 이해해야 할 때 유용합니다.
프로젝트를 위한 경로 선택
Claude 단독이든 다른 제공자와 함께 사용하든, 토큰 지출을 줄이는 것이 우선이라면 CometAPI로 시작하세요. 기존 클라이언트 코드로 대표적인 요청을 테스트해 필요한 기능을 확인하세요. 제공자별 계정 제어가 요구사항의 중심이라면 Anthropic 직접 접근을 선택하세요. 어느 경로든 프로덕션 트래픽을 이동하기 전에 작업 완료율, 사용량, 지연 시간을 확인하세요.
Claude Fable 5.2 API 사용 방법 단계별 안내
첫 요청을 위해 접근 경로 하나를 선택하세요. Python 예제는 작은 구성 파일을 공유하므로, 이후 요청 본문을 다시 쓰지 않고 다른 경로를 테스트할 수 있습니다.
1단계: API 키 생성
공식 접근의 경우, Claude Console에서 API 키 설정을 따르세요. 이 튜토리얼을 위한 워크스페이스 범위의 키를 사용하고, 계정에 접근 권한과 과금이 구성되어 있는지 확인하세요. ANTHROPIC_API_KEY로 저장하세요. 워크스페이스 범위가 아닌 키는 Anthropic 인증 문서에 설명된 워크스페이스 헤더도 필요합니다.
CometAPI의 경우, API 대시보드에서 키를 생성하고 모델 접근과 잔액을 확인하세요. COMETAPI_KEY로 저장하세요. 한 제공자의 키는 다른 제공자의 엔드포인트에 인증할 수 없습니다.
키는 안전하게 보관하세요. 자격 증명을 애플리케이션 소스 코드나 프런트엔드 JavaScript에 직접 넣지 마세요.
macOS 또는 Linux에서, Python을 실행할 셸에서 해당 변수를 설정하세요:
# 선택한 경로에 해당하는 변수를 설정합니다.
export ANTHROPIC_API_KEY="your_anthropic_api_key"
# 또는 CometAPI의 경우:
export COMETAPI_KEY="your_cometapi_api_key"
Windows PowerShell에서는 해당 환경 변수를 사용하세요:
# 선택한 경로에 해당하는 변수를 설정합니다.
$env:ANTHROPIC_API_KEY = "your_anthropic_api_key"
# 또는 CometAPI의 경우:
$env:COMETAPI_KEY = "your_cometapi_api_key"
2단계: cURL로 첫 요청 보내기
이는 대체 가능한 Bash 명령입니다. Python을 도입하기 전에 선택한 계정의 HTTP 응답을 확인하려면 해당하는 명령을 실행하세요.
아래 내용을 fable52_stream.py로 저장하고 python fable52_stream.py를 실행하세요:
from client_config import client, MODEL
with client.messages.stream(
model=MODEL,
max_tokens=8192,
messages=[{
"role": "user",
"content": "Design a fault-tolerant microservice architecture.",
}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
final_message = stream.get_final_message()
print("\nStop reason:", final_message.stop_reason)
print("Usage:", final_message.usage)
모델이 reasoning을 수행하는 동안 첫 텍스트가 나타나기 전에 지연이 있을 수 있습니다. 헬퍼가 성공적으로 끝난 뒤에만 스트림을 완료된 것으로 처리하세요. 부분 텍스트만으로 답변이 완료되었다고 확인할 수는 없습니다.
다중 턴 대화 기록 보존
상태를 유지하는 채팅 인터페이스와 달리, 표준 Messages API는 애플리케이션이 대화 기록을 제공하기를 기대합니다.
아래 내용을 fable52_history.py로 저장하고 python fable52_history.py를 실행해 관련된 두 요청을 만드세요:
from client_config import client, MODEL
history = [{
"role": "user",
"content": "Design a scalable event-processing architecture.",
}]
first = client.messages.create(
model=MODEL,
max_tokens=8192,
output_config={"effort": "high"},
messages=history,
)
if first.stop_reason != "end_turn":
raise RuntimeError(f"First turn is incomplete: {first.stop_reason}")
history.append({
"role": "assistant",
"content": [block.model_dump() for block in first.content],
})
history.append({
"role": "user",
"content": "Now identify its three highest-risk failure scenarios.",
})
second = client.messages.create(
model=MODEL,
max_tokens=8192,
output_config={"effort": "high"},
messages=history,
)
for block in second.content:
if block.type == "text":
print(block.text)
print("Stop reason:", second.stop_reason)
예제는 첫 번째 응답의 보이는 텍스트만 추출하지 않고, assistant의 전체 content를 보존하는 점에 주목하세요.
Fable 5.2는 이전 대화에 대해 thinking을 검증합니다. 해당 블록을 재생할 때 이전 메시지, 시스템 지시문, 도구 정의를 변경하지 마세요. 접두사를 재구성하는 대신 다음 턴을 덧붙이세요.
Anthropic의 컨텍스트와 압축 일러스트는 긴 세션이 결국 더 작은 작업용 기록을 필요로 하는 이유를 보여줍니다. 다이어그램은 Claude Code에서 가져왔으며, 커스텀 API 애플리케이션은 자체 컨텍스트 관리를 구현해야 합니다.
이 튜토리얼에서는 짧은 기록을 그대로 유지하세요. 더 긴 애플리케이션에 압축을 추가하기 전에, 게이트웨이가 문서화된 서버 측 옵션을 지원하는지 확인하세요. 요약에서 새 대화를 시작한다면, 이전 접두사의 서명된 thinking 블록을 첨부하지 마세요.
분석을 위한 이미지 전송
네이티브 이미지 입력 포맷은 텍스트 지시와 함께 이미지 블록을 배치합니다. 이 예제는 로컬 PNG를 읽습니다. 더 큰 입력을 사용하기 전에 선택한 게이트웨이 경로에서 이미지 지원과 크기 제한을 확인하세요.
스크립트 옆에 dashboard.png를 두고, 아래 내용을 fable52_vision.py로 저장한 뒤 python fable52_vision.py를 실행하세요:
import base64
from pathlib import Path
from client_config import client, MODEL
image_data = base64.b64encode(
Path("dashboard.png").read_bytes()
).decode("ascii")
response = client.messages.create(
model=MODEL,
max_tokens=4096,
messages=[{
"role": "user",
"content": [
{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/png",
"data": image_data,
},
},
{
"type": "text",
"text": "Identify three usability issues in this dashboard.",
},
],
}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Stop reason:", response.stop_reason)
애플리케이션 제어 도구 추가
클라이언트 측 도구 루프에서는 입력 스키마로 도구를 정의하고, 반환된 tool_use 블록을 읽고, 애플리케이션에서 허용된 작업을 실행한 다음, 다음 사용자 메시지에서 일치하는 tool_result 블록을 전송합니다. 이러한 결과를 반환하기 전에 assistant의 전체 응답을 보존하세요.
레코드 조회와 같은 읽기 전용 도구로 시작하세요. 인자를 검증하고 tool_use를 작업의 연속으로 처리하세요. 모델이 도구 호출을 생성한다고 해서 애플리케이션 코드가 자동으로 실행되는 것은 아닙니다.
Claude Fable 5.2 API 비용은?
아래의 다섯 가지 토큰 범주 전반에 걸쳐 CometAPI의 공개 요율은 Anthropic 표준 요율 대비 20% 낮습니다. 가격은 백만 토큰당 USD입니다. 워크로드 추정 시 각 경로에서 동일한 범주를 비교하세요.
백만 토큰당 요율
Anthropic 직접 API
CometAPI 표시 요율
표준 입력
$8
$6.4
표준 출력
$40
$32
캐시 쓰기, 5분 TTL
$10
$8
캐시 쓰기, 1시간 TTL
$16
$12.8
캐시 읽기
$0.20
$0.16
요율 확인일: 2026년 11월 10일. 이 비교는 계정별 계약이나 추가 도구 비용 이전의 공개 표준 API 요율을 사용합니다.
캐시 미사용 요청 견적
캐시 없이 입력 토큰 100,000, 출력 토큰 10,000인 경우, CometAPI 예상 비용은 (0.1 x $6.40) + (0.01 x $32) = $0.96입니다. 동일한 토큰 사용량을 Anthropic 표준 요율로 사용하면 (0.1 x $8) + (0.01 x $40) = $1.20입니다. 요청당 $0.24, 즉 20%를 절감합니다. 추가 도구 비용 이전 기준입니다.
해당 토큰 사용량으로 1,000건의 요청을 수행하면, 예상 토큰 지출은 $1,200에서 $960으로 줄어 $240이 추가 실행이나 다른 모델 워크로드에 남습니다. 프로덕션 예산에서는 실제 청구된 토큰 수를 사용하고 재시도, 캐시 작업, 별도 과금 도구를 포함하세요.
CometAPI의 모델 및 제공자 폴백 가이드는 유용한 다음 단계입니다. 호환되는 보조 모델은 동일한 CometAPI 키와 base URL을 사용할 수 있으며, 필요한 경우 별도로 구성된 공식 경로를 둘 수 있습니다. 애플리케이션이 폴리시를 구현해야 하며, 모델 ID만으로 콘텐츠 포맷이 정규화되거나 성공적인 복구가 보장되지는 않습니다.
Claude Fable 5.2의 제한 사항
고급 기능에도 불구하고, Fable 5.2에는 몇 가지 실용적 제약이 있습니다:
더 높은 토큰 비용: 백만 입력 토큰당 $8, 백만 출력 토큰당 $40으로, Opus 5.5보다 상당히 비쌉니다.
중간 수준의 지연: 고급 추론과 장기 작업 능력이 지연 시간 민감 애플리케이션에 최적이라는 의미는 아닙니다.
Adaptive thinking 비활성화 불가: 개발자는 effort 설정을 통해 reasoning 깊이를 관리해야 합니다.
제한된 사이버보안 및 생물학 작업: Fable은 특정 고위험 사이버보안 및 생물학 연구 요청을 차단하는 안전 분류기를 포함합니다.
API 파라미터 제한: tool_choice의 any 및 tool 유형을 사용한 강제 도구 선택은 400 오류를 반환합니다. temperature, top_p, top_k와 같은 샘플링 파라미터는 생략해야 합니다.
데이터 보존 요구사항: Anthropic의 모델 문서는 명시적 예외가 승인되지 않는 한 Fable 5.2에 대해 30일 데이터 보존을 명시합니다.
일반적인 설정 점검
증상
첫 조치
401 또는 403
선택한 엔드포인트에 해당 키가 속해 있고 모델 접근 권한이 있는지 확인하세요.
Unknown model 또는 404
base URL과 정확한 모델 ID를 확인하세요.
400 invalid request
지원되지 않는 필드 또는 잘못 보존된 접두사에 대한 오류 본문을 확인하세요.
max_tokens stop reason
다음 요청을 시작하기 전에 부분 답변과 출력 예산을 검토하세요.
예상치 못한 실패의 경우, 시간, 모델 ID, 상태, (존재 시) 요청 ID를 기록하세요. API 키와 민감한 프롬프트 텍스트는 상시 로그에서 제외하세요.
FAQ
Claude Fable 5.2 API 접근 권한은 어떻게 얻나요?
Anthropic 직접 접근 또는 CometAPI 중 하나를 선택하고, 해당 제공자의 API 키를 생성하여 과금 또는 잔액을 구성하세요. 모델은 claude-fable-5-2로 설정해 첫 Messages 요청을 보내세요. 본 가이드에서 사용한 엔드포인트는 https://api.anthropic.com/v1/messages와 https://api.cometapi.com/v1/messages.입니다. 호출하는 제공자가 발급한 키를 사용하세요. 키는 상호 호환되지 않습니다. 설정 섹션과 CometAPI의 Messages 문서를 따라 게이트웨이 경로를 설정하세요.
Claude Fable 5.2 API 비용은 얼마인가요?
Anthropic 표준 가격은 백만 입력 토큰당 $8, 백만 출력 토큰당 $40입니다. CometAPI는 각각 $6.40과 $32로 표시합니다(확인일: 2026년 11월 11일). 해당 요율에서 캐시와 추가 요금 없이 입력 100,000 토큰과 출력 10,000 토큰의 비용은 직접 접근 시 $1.20, CometAPI를 통해서는 $0.96입니다. 캐시 작업과 선택 모드는 별도 요율이 있습니다.
Anthropic Python SDK를 CometAPI와 함께 사용할 수 있나요?
가능합니다. CometAPI는 Anthropic 호환 Messages 엔드포인트를 문서화합니다. Anthropic 클라이언트를 CometAPI 키와 base_url="https://api.cometapi.com"로 구성한 뒤 client.messages.create를 사용하세요. 본 가이드에서 SDK base URL에는 /v1 접미사가 없습니다. 모델 ID는 claude-fable-5-2로 유지하고, 의존하기 전에 선택 기능을 경로에서 검증하세요.
Claude Fable 5.2 API에서 thinking을 비활성화할 수 있나요?
불가능합니다. Fable 5.2는 항상 켜져 있는 adaptive thinking을 사용합니다. output_config.effort로 reasoning 깊이를 제어하세요. API 기본값은 high입니다. 비활성화된 thinking이나 수동 budget_tokens 구성은 보내지 마세요. 마이그레이션 가이드가 지원 설정을 설명합니다. 비용 또는 지연을 줄이고 싶다면 대표 작업에서 낮은 effort를 테스트하세요.
Claude Fable 5.2는 이미지 입력과 1M 토큰 컨텍스트 윈도우를 지원하나요?
예. 모델 사양에는 텍스트 및 이미지 입력, 텍스트 출력, 1M 토큰 컨텍스트 윈도우, 최대 128K 출력 토큰이 명시되어 있습니다. 이미지 입력은 기존 이미지를 분석하는 용도이며, 이미지를 생성하는 기능은 아닙니다. 큰 페이로드를 보내기 전에는 선택한 경로의 요청 크기 제한을 확인하세요.
모델 ID만 바꿔서 Fable 5.1에서 마이그레이션할 수 있나요?
신규의 간단한 텍스트 요청은 모델 변경만으로 충분할 수 있지만, 프로덕션 통합에는 더 많은 점검이 필요합니다. 공식 마이그레이션 가이드는 대화 접두사 검증, thinking 블록 호환성, 컴퓨터 사용, advisor 선택의 변경 사항을 제시합니다. 특히 애플리케이션이 기록을 편집하거나, 대화 중간에 모델을 전환하거나, 해당 도구를 사용하는 경우 마이그레이션 섹션을 따르세요.
Claude Fable 5.2 API 요청이 400 오류를 반환하는 이유는 무엇인가요?
먼저 응답의 오류 메시지를 확인하세요. 일반적인 원인은 지원되지 않는 thinking 설정, assistant prefill, 강제 도구 선택, 선행 대화를 변경한 뒤 thinking 블록을 재생성하는 경우 등입니다. Anthropic의 마이그레이션 가이드가 이러한 제한을 설명합니다. 최소한의 새 요청으로 문제를 재현한 뒤 옵션과 기록을 점진적으로 되돌려 추가하세요. 동일한 잘못된 요청을 재시도해도 문제는 해결되지 않습니다.
Claude Fable 5.2 API 레이트 리밋은 어떻게 처리해야 하나요?
동시 요청을 줄이고, 게이트웨이가 반환하는 Retry-After를 따르세요. Python SDK 재시도 구성을 통해 자동 재시도를 제한할 수 있으며, 이미 429 응답 등 선택적 일시적 실패를 재시도합니다. 무제한 애플리케이션 재시도 루프를 그 위에 쌓지 마세요. 실패가 지속되면 재시도 횟수를 늘리기보다 선택한 계정의 쿼터와 잔액을 확인하세요.
결론
경로를 선택하고, 해당 클라이언트 구성을 저장한 뒤, 반환된 stop reason과 사용량을 설명할 수 있을 때까지 텍스트 예제를 실행하세요. 그런 다음 제품이 실제로 받을 입력으로 한 번에 하나의 추가 기능을 검증하세요.
CometAPI를 통해 소규모 프로덕션 유사 파일럿을 실행하고 위의 추정치와 기록된 토큰 요금을 비교하세요. 로드맵에 다른 제공자가 포함되어 있다면, 공유 접근 및 청구 워크플로를 테스트하기 위해 두 번째 모델을 추가하세요. 네이티브 요구사항이 있을 때를 대비해 Anthropic 직접 접근을 유지하고, 품질과 예산 목표를 충족하는 구성을 확장하세요.
