Claude Fable 5.1 API 실전 가이드: 가격·1M 컨텍스트·보안·마이그레이션

기준일: 2026년 9월 3일

Claude Fable 5.1에 대한 첫 소식보다 개발자에게 더 중요한 것은 “우리 서비스에 실제로 어떻게 붙일 것인가”입니다. 모델 이름만 바꾸면 되는지, thinking 설정은 어떻게 달라졌는지, 긴 컨텍스트와 캐시는 비용에 어떤 영향을 주는지, 보안·데이터 보존 조건 때문에 도입을 미뤄야 하는 경우는 무엇인지까지 확인해야 합니다.

이 글은 2026년 9월 1일 공개된 공식 문서를 바탕으로 Fable 5.1 API 도입을 기술 관점에서 정리합니다. 직접 벤치마크를 수행한 것처럼 꾸미지 않고, 공식 사양과 재현 가능한 점검 절차를 구분했습니다. 가격·지역·제공 방식은 바뀔 수 있으므로 실제 배포와 결제 전 링크된 최신 문서를 다시 확인하세요.

Fable 5.1 API 핵심 사양 한눈에 보기

Anthropic은 Fable 5.1을 장시간 코딩, 여러 도구를 사용하는 에이전트, 복잡한 지식 업무에 맞춘 일반 제공 모델로 설명합니다. 개인용 Claude에서는 Pro·Max·Team·Enterprise 이용자가 접근할 수 있고, 개발자는 Claude Platform과 AWS, Google Cloud, Microsoft Foundry를 통해 사용할 수 있습니다. Claude API의 기본 모델 식별자는 claude-fable-5-1입니다.

항목	공식 확인 내용	도입 시 확인할 점
출시일	2026년 9월 1일	SDK와 리전별 제공 시점은 다를 수 있음
Claude API 모델 ID	claude-fable-5-1	별칭 고정 여부와 버전 정책 확인
컨텍스트	최대 1M 토큰	길다고 모든 정보를 동일하게 잘 쓰는 것은 아님
최대 출력	AWS 모델 카드 기준 128K 토큰	플랫폼별 제한과 계정 한도 확인
기본 가격	입력 $10/MTok, 출력 $50/MTok	클라우드·리전·도구 비용은 별도 가능
추론 방식	Adaptive thinking	budget_tokens 방식에서 마이그레이션 필요
데이터 보존	Covered Model, 기본 최소 30일	ZDR·규제 요구사항과 충돌 여부 확인

Anthropic의 Fable 공식 페이지는 가격과 제공 채널, 안전장치, 보존 정책을 함께 안내합니다. AWS에서 사용할 경우에는 Amazon Bedrock Fable 5.1 모델 카드에서 endpoint, 지원 API, 리전, 요청 제한을 별도로 확인하는 것이 좋습니다.

모델 이름만 바꾸면 끝나지 않는 이유

기존 Claude 연동이 Messages API의 단순 질의·응답이라면 모델 ID 교체만으로 첫 호출이 성공할 수 있습니다. 하지만 장시간 에이전트나 다중 턴 대화는 사고 블록, 도구 정의, 시스템 프롬프트, 캐시, 재시도 로직까지 함께 검토해야 합니다. 특히 이전 세대의 수동 extended thinking을 사용했다면 설정을 그대로 복사하면 오류가 날 수 있습니다.

Fable 5.1은 복잡도에 맞춰 추론량을 조절하는 adaptive thinking을 사용합니다. 수동으로 budget_tokens를 지정하는 대신 thinking.type을 adaptive로 두고, output_config.effort로 품질·지연·비용의 균형을 조절하는 방식입니다. 지원되는 노력 수준은 플랫폼 문서와 SDK 버전에 따라 확인해야 하며, 운영에서는 무조건 가장 높은 값보다 작업별 합격 기준을 먼저 정하는 것이 중요합니다.

from anthropic import Anthropic

client = Anthropic()

message = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=4096,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[
        {
            "role": "user",
            "content": "이 코드 변경의 위험을 근거와 함께 검토해 주세요."
        }
    ],
)

print(message.content)

위 코드는 구조를 보여 주는 최소 예시입니다. 실제 필드 지원 여부는 설치된 Anthropic SDK와 최신 API 문서에서 확인해야 합니다. 기존 환경의 budget_tokens를 그대로 남겨 두거나, effort를 thinking 객체 안에 넣으면 요청 검증 오류가 발생할 수 있습니다.

가격은 토큰 단가보다 작업 한 건으로 계산하기

Anthropic 발표 기준 Fable 5.1의 기본 단가는 입력 100만 토큰당 10달러, 출력 100만 토큰당 50달러입니다. 발표 페이지는 캐시 읽기 단가를 100만 토큰당 0.25달러로 안내하며 Fable 5보다 낮아졌다고 설명합니다. 다만 AWS·Google Cloud·Microsoft Foundry는 리전, 배포 방식, 마켓플레이스 계약에 따라 청구 구조가 달라질 수 있습니다.

비용 비교는 “질문 1회”가 아니라 “완료된 작업 1건”으로 해야 합니다. 예를 들어 한 작업에서 캐시가 아닌 입력 10만 토큰과 출력 1만 토큰을 사용한다면 기본 토큰 비용의 단순 계산은 입력 1달러와 출력 0.5달러, 합계 1.5달러입니다. 여기에 웹 검색, 관리형 에이전트 실행 시간, 데이터 리전 프리미엄, 재시도 비용이 붙을 수 있습니다.

비용 변수	확인 방법	줄이는 방법
반복 시스템 프롬프트	캐시 생성·읽기 토큰 분리	안정된 앞부분을 캐시
과도한 출력	완료물당 출력 토큰 기록	형식과 길이 상한을 명시
불필요한 최고 effort	난이도별 성공률 비교	단순 작업은 낮은 effort 검토
긴 도구 결과	tool result 크기 측정	필요한 필드만 반환
재시도	오류 유형별 횟수 집계	무조건 재시도 대신 오류 분기

Claude Platform 가격 문서는 캐시, 배치, 리전, 도구 사용이 비용에 미치는 방식을 설명합니다. Fable 5.1 고유 단가는 출시 페이지를 우선 확인하고, 실제 응답의 usage 필드와 클라우드 청구 내역을 함께 대조하세요.

1M 컨텍스트를 제대로 활용하는 입력 설계

1M 토큰 컨텍스트는 여러 저장소, 계약서 묶음, 장기 에이전트 기록을 한 요청에 넣을 수 있다는 뜻이지, 모든 토큰을 동일한 정확도로 기억하거나 판단한다는 보장은 아닙니다. 대량 문서를 무작정 연결하면 비용이 증가하고 관련 없는 정보가 판단을 흐릴 수 있습니다.

먼저 문서 목록과 버전을 구조화하고, 작업에 필요한 범위를 검색으로 좁힌 뒤, 선택된 근거와 목표를 함께 전달하는 편이 좋습니다. 코드 작업은 저장소 전체를 매번 보내기보다 파일 지도, 변경 대상, 테스트 명령, 실패 로그를 분리합니다. 장시간 에이전트에는 “완료”의 기준과 중간 체크포인트, 되돌릴 수 없는 작업의 승인 지점을 명시하세요.

1. 문서·코드의 출처, 날짜, 버전을 메타데이터로 붙인다.
2. 검색이나 인덱스로 후보를 줄이고 관련 근거만 요청에 넣는다.
3. 핵심 제약은 시스템 프롬프트와 작업 시작 부분에 명확히 둔다.
4. 답변마다 근거 파일과 위치를 반환하게 한다.
5. 중요 숫자·API 호출·테스트 결과는 외부 검증기로 확인한다.

문서 안의 표와 다이어그램을 보는 vision 기능도 강점으로 소개됐지만, 금융·법률 문서의 숫자를 자동 확정값으로 사용하면 안 됩니다. 추출된 값과 원본 표의 행·열·각주를 직접 비교하는 검증 단계가 필요합니다.

AWS·Google Cloud·직접 API의 차이

같은 Fable 5.1이라도 호출 방법과 모델 식별자가 플랫폼마다 다릅니다. 직접 Claude API에서는 claude-fable-5-1을 사용합니다. Amazon Bedrock의 기본 모델 ID는 anthropic.claude-fable-5-1이고, 글로벌 추론 프로필 예시는 global.anthropic.claude-fable-5-1입니다. Google Cloud에서는 Vertex AI endpoint URL에 모델을 지정하며 SDK 예제는 claude-fable-5-1을 사용합니다.

경로	대표 식별 방식	주요 확인점
Claude API	claude-fable-5-1	workspace 보존 설정, rate limit, SDK
Amazon Bedrock	global.anthropic.claude-fable-5-1	지원 리전, inference profile, retention mode
Google Cloud	endpoint URL의 모델 경로	Vertex AI 활성화, global/region, IAM
Microsoft Foundry	배포·마켓플레이스 구성	배포 지역, CCU 청구, 데이터 정책

Bedrock 모델 카드 기준 bedrock-runtime에서는 Messages, Converse, Invoke가 지원되지만 OpenAI 형식의 Responses와 Chat Completions는 지원되지 않습니다. 기존 OpenAI 호환 계층을 그대로 재사용하려 했다면 중간 어댑터가 필요한지 먼저 확인하세요. 서울 리전이 목록에 보여도 in-region 제공이 아니라 global routing만 지원될 수 있으므로 데이터 경로 요구사항도 따로 검토해야 합니다.

보존된 사고와 다중 턴 에이전트의 변경점

Fable 5.1의 새 API 계정에서는 다중 턴 대화에 이전 사고 블록을 다시 보낼 때 그 사고를 생성한 시스템 프롬프트, 도구, 이전 메시지를 임의로 바꾸면 오류가 발생할 수 있습니다. Anthropic은 불법 증류 방지를 위해 사고 블록 주변의 컨텍스트 일치 여부를 확인한다고 설명합니다.

이 변화는 대화 기록을 압축하거나, 중간에 시스템 알림을 주입하거나, 오래된 도구 정의를 제거하는 에이전트에 직접 영향을 줄 수 있습니다. 가장 안전한 마이그레이션은 원본 대화 묶음을 불변 데이터처럼 취급하고, 수정이 필요하면 공식 문서가 안내하는 비엄격 모드 또는 사고 블록 제거 경로를 검토하는 것입니다. 어떤 경우에도 서명된 사고 블록을 직접 편집해서는 안 됩니다.

Anthropic의 한국어 ‘보존된 사고’ 안내에는 영향을 받는 계정과 오류 회피 방법이 정리돼 있습니다. 운영 중인 에이전트라면 배포 전에 컨텍스트 압축, 세션 복원, 도구 스키마 변경 테스트를 반드시 포함하세요.

30일 데이터 보존과 안전장치를 먼저 검토하기

Fable 5.1은 Anthropic이 분류한 Covered Model입니다. 공식 정책은 기본적으로 프롬프트와 출력의 최소 30일 보존을 요구하며, 안전 조사나 법적 요구가 있으면 더 길어질 수 있다고 설명합니다. 일부 적격 기업을 위한 예외와 Enterprise Frontier Safeguards가 있지만 모든 계정이 자동으로 적용받는 것은 아닙니다.

따라서 ZDR이 필수인 서비스, 의료·금융·법률 데이터, 고객 기밀 코드를 처리하는 시스템은 성능 테스트보다 데이터 흐름 검토가 먼저입니다. 직접 API인지 Bedrock인지에 따라 누가 데이터를 보존하고 검토하는지도 달라질 수 있습니다. AWS에서는 보존 데이터가 AWS 경계에 머무는 구성이 안내되지만 계정 모드와 자격 요건을 확인해야 합니다.

또한 사이버보안과 생명과학 질문에는 차단 분류기가 적용되고 일부 요청은 다른 모델로 전환되거나 거절될 수 있습니다. Bedrock 모델 카드는 거절을 예외가 아닌 정상 응답 경로로 처리하고 stop_reason과 세부 정보를 검사하라고 안내합니다. 민감 분야 앱은 “항상 Fable이 답한다”는 가정으로 후속 로직을 짜면 안 됩니다.

• 30일 보존이 내부 규정과 계약에 맞는가?
• 직접 API와 클라우드 중 보존 주체를 확인했는가?
• 민감정보를 최소화하거나 비식별화했는가?
• refusal과 fallback을 정상 분기로 처리하는가?
• 모델 전환 시 가격·품질·로그 표시가 정확한가?

Anthropic Covered Models 정책에서 현재 제공 플랫폼과 보존 원칙을 확인할 수 있습니다.

기존 Claude 연동을 옮기는 8단계 체크리스트

1. 기준선 저장: 현재 모델의 성공률, 지연, 토큰, 비용을 작업 유형별로 기록합니다.
2. SDK 업데이트: 새 모델 ID와 adaptive thinking 필드를 지원하는지 확인합니다.
3. 모델 ID 분리: 코드에 직접 박지 말고 환경별 설정으로 관리합니다.
4. thinking 변경: budget_tokens를 제거하고 adaptive thinking과 effort를 시험합니다.
5. 세션 복원 테스트: 보존된 사고와 시스템·도구 정의가 그대로 재전송되는지 봅니다.
6. 거절 분기 추가: refusal과 fallback을 오류 재시도와 구분합니다.
7. 비용 상한 설정: 최대 입력·출력, 도구 횟수, 실행 시간을 제한합니다.
8. 점진 배포: 일부 트래픽부터 보내 품질과 비용을 비교한 뒤 확대합니다.

평가 문제는 실제 업무에서 수집하되 개인정보와 기밀은 제거하세요. 코딩이라면 테스트 통과뿐 아니라 잘못된 테스트 삭제, 보안 회귀, 성능 저하도 측정합니다. 문서 업무라면 숫자 정확성, 인용 위치, 예외 조건 보존을 별도 점수로 둡니다.

자주 발생할 수 있는 실패와 해결 방향

400 오류: 기존 thinking 설정을 그대로 사용

수동 extended thinking의 thinking.type=enabled와 budget_tokens 조합이 새 모델에서 지원되지 않을 수 있습니다. adaptive 방식으로 바꾸고 effort의 위치를 공식 예제와 맞춥니다.

다중 턴 재개 시 컨텍스트 불일치

저장된 사고 블록 이전의 시스템 프롬프트, 메시지, 도구를 변경했는지 확인합니다. 세션 원본을 보존하고 공식 비엄격 처리 방식을 검토합니다.

Bedrock에서 OpenAI 호환 endpoint를 호출

Bedrock 모델 카드의 지원 API 표를 확인합니다. Messages, Converse, Invoke 중 환경에 맞는 방식을 사용하고 Responses·Chat Completions 호환을 가정하지 않습니다.

서울 리전을 선택했는데 데이터 경로가 예상과 다름

콘솔에 지역명이 보이는 것과 in-region inference 지원은 다를 수 있습니다. global, geo, in-region 옵션과 실제 라우팅 정책을 배포 전에 확인합니다.

안전장치 거절을 장애로 보고 무한 재시도

동일 요청을 반복하는 대신 refusal을 정상 결과로 기록하고 사용자에게 제한을 설명합니다. 공식 fallback 설정이 필요한 계정은 별도 절차를 적용합니다.

자주 묻는 질문

Fable 5.1은 일반 챗봇에도 가장 좋은 선택인가요?

반드시 그렇지는 않습니다. 짧고 단순한 응답은 더 저렴하고 빠른 모델이 작업당 비용 면에서 유리할 수 있습니다. Fable 5.1은 장시간 코딩, 복합 에이전트, 어려운 지식 업무처럼 실패 비용이 큰 작업에서 먼저 비교하는 편이 합리적입니다.

1M 컨텍스트를 전부 사용해도 기본 단가가 같나요?

Anthropic 가격 문서는 Claude 4.6 이후 모델의 1M 컨텍스트가 표준 토큰 단가 범위에 포함된다고 안내합니다. 그러나 사용 토큰 자체가 많아지므로 총액은 커지고, 클라우드 리전과 부가 기능 비용도 추가될 수 있습니다.

Fable 5.1과 Mythos 5.1은 같은 모델인가요?

Anthropic 정책 문서는 같은 기반 모델을 공유하지만 Fable에는 사이버보안과 생명과학 분야의 추가 안전장치가 있다고 설명합니다. Mythos는 승인된 조직에 제한 제공되므로 일반 개발자가 동일하게 선택할 수 있는 모델로 보면 안 됩니다.

기존 프롬프트는 그대로 재사용해도 되나요?

먼저 평가 세트에서 비교해야 합니다. 특히 과도한 상세 지시, 장시간 진행 상황 표현, tool loop, thinking 설정, 세션 압축 로직은 새 동작과 충돌할 수 있으므로 항목별로 점검하세요.

공식 확인 자료

• Anthropic — Claude Fable 5.1 기능·가격·제공 범위
• Claude Platform Docs — 모델·캐시·리전·도구 가격
• Amazon Bedrock — Claude Fable 5.1 모델 카드와 API 예제
• Anthropic Support — Covered Models 정책과 데이터 보존
• Anthropic Support 한국어 — Fable 5.1 보존된 사고 변경
• Google Cloud — Claude Fable 5.1 Agent Platform 모델 페이지

이 글은 공식 문서를 바탕으로 한 기술 가이드이며 특정 모델 구매나 사용을 권유하지 않습니다. 실제 계약, 데이터 처리, 가격과 사용 가능 지역은 계정과 플랫폼에 따라 다를 수 있으므로 배포 전 최신 약관과 콘솔 설정을 확인하세요.