Claude Fable 5.1 API 사용 방법

빠른 요약: CometAPI에서 Claude Fable 5.1 API를 사용하려면 API 키를 준비하고, 모델 ID를 claude-fable-5-1로 설정한 뒤, 긴 워크플로를 구축하기 전에 소규모 요청으로 유효성을 검증하세요. 이 가이드는 액세스, 추론 강도, 스트리밍, 도구, 캐싱, 마이그레이션, 프로덕션 점검을 다룹니다. 배포는 단순히 모델 문자열을 바꾸는 일이 아닙니다. 라우트 호환성을 확인하고, 출력을 검증하며, 확대 적용 전에 승인된 작업 품질, 지연 시간, 비용을 측정하세요.

핵심 요점

• 먼저 한 번의 요청이 동작하는지 확인: 자격 증명, 모델 액세스, 선택한 엔드포인트, 비민감 테스트 데이터로부터 사용 가능한 응답을 확인하세요.
• 추론 강도를 목적에 맞게 선택: 처음엔 높게 시작하되, 대표 작업에서 다른 설정을 비교하세요. 모든 요청에 최대 강도를 쓰지는 마세요. Claude Code 기본값은 High입니다. Claude Cowork / Claude.ai 기본값은 Medium입니다.
• 마이그레이션 동작 검토: 강제 도구 선택은 거부됩니다. 필수 워크플로 단계와 도구 인자 검증은 애플리케이션 코드에서 유지하세요.
• 전체 워크플로를 측정: 캐시 사용, 토큰 비용, 지연, 거부, 폴백 동작, 최종 결과가 승인 기준을 통과하는지 추적하세요.

배경 자료: CometAPI의 이전 Fable 5.1 추적기와 Fable 5 API 튜토리얼. 본 문서는 현재 통합 워크플로에 집중합니다.

Claude Fable 5.1이란?

Claude Fable 5.1은 야심찬 코딩, 다단계 리서치, 컴퓨터 사용, 문서 집약적 전문 워크플로를 위한 Anthropic의 최고 성능 일반 모델입니다. Anthropic은 대부분의 워크로드를 Claude Opus 5로 시작하고, 높은 추론 강도의 Opus 평가로도 부족할 때 Fable 5.1로 상향할 것을 권장합니다.

차이는 운영적입니다. Fable 5.1은 종속 단계 전반에서 작업을 이어가고, 실패한 도구 호출 후 회복하며, 결과를 검증하고, 긴 실행 동안 진행 상황을 보고하도록 설계되었습니다. 이는 완료율을 높일 수 있지만, 배포에서 비용, 지연, 가시성을 핵심 고려 요소로 만듭니다.

Claude Fable 5.1 API 사양

공식 개요는 100만 컨텍스트와 128K 최대 출력을 확인합니다. 적응형 사고는 항상 활성이며, 추론 깊이는 전통적인 thinking-token 예산이 아닌 추론 강도로 제어합니다.

Claude Fable 5.1 API: 공식 벤치마크 성능

이 글의 목적이 구현이므로 벤치마크 요약은 의도적으로 간결합니다. 아래 결과는 API 프리미엄이 특히 의미 있는 영역을 보여줍니다.

Anthropic의 공식 Claude Fable 5.1 벤치마크 비교

이 세트에서 가장 큰 세대 간 향상은 Terminal-Bench-Science로 52.6% 대 24.7%입니다. AutomationBench는 17.1%에서 31.4%로 상승하고, Terminal-Bench 4.0은 55.8%로 개선됩니다. 이는 Fable 5.1을 리서치 에이전트, 장시간 코딩, 비즈니스 자동화에 테스트할 강력한 근거가 되지만, 모든 짧은 요청을 가장 비싼 모델로 라우팅할 근거는 아닙니다.

Claude Fable 5 API에서 무엇이 바뀌었나?

호환성 파괴 변경 3가지

강제 도구 사용은 더 이상 지원되지 않음

Claude Fable 5.1은 임의 도구 또는 특정 도구를 강제하는 tool_choice 값을 400 invalid-request 오류로 거부합니다. 자동 선택을 유지하고, 검증에는 엄격한 스키마 또는 구조화 출력을 사용하며, 필수 워크플로 단계는 모델 도구 호출 강제 대신 애플리케이션 오케스트레이션에서 집행하세요.

이전 모델은 Fable 5.1 사고 블록을 읽을 수 없음

사고 호환성은 단방향입니다. Fable 5.1은 이전 호환 Claude 모델이 생성한 사고 블록을 소비할 수 있지만, 이전 모델은 Fable 5.1이 생성한 블록을 읽을 수 없습니다. 이전 모델로의 라우터나 폴백은 추론 전에 해당 블록을 제거할 수 있으므로, 모델 전환을 로깅하고 폴백 동작을 명시적으로 테스트하세요.

이전 턴 편집은 보존 사고를 무효화함

이전 시스템 프롬프트, 도구 정의, 메시지 또는 참조 파일 바이트를 변경하면 이후 사고 블록이 무효화될 수 있습니다. 대화 접두부는 append-only로 취급하고, 히스토리를 재작성하는 대신 대화 중간 지시를 사용하며, 마이그레이션 중 접두부 불일치 변환을 모니터링하세요.

추가된 API 기능 5가지

메시지별 추론 강도

애플리케이션은 프롬프트 캐시를 무효화하지 않고 대화 중 추론 강도를 변경할 수 있습니다. 이 베타 기능은 루틴 후속 작업에서 강도를 낮추고, 계획·디버깅·검증 턴에서 높일 수 있게 해줍니다.

턴 범위 시스템 메시지

베타 시스템 메시지는 한 턴에만 적용되고, 다음 사용자 메시지 이후 렌더링이 중지되며 히스토리에서는 변하지 않습니다. 도구 루프에서 임시 지시에 유용하며, 프롬프트 캐시 일치를 유지하고 이후 사고 블록의 유효성을 보존합니다.

도구 호출 사이 읽기 가능한 진행 업데이트

베타 progress-display 옵션을 사용하면 선택된 사고 블록이 짧은 상태 업데이트를 담아 애플리케이션이 사용자에게 표시할 수 있습니다. 장시간 에이전트는 이 업데이트를 최종 답변이 아닌 운영 상태로 취급해야 합니다.

낮아진 캐시 읽기 가격

캐시 읽기는 백만 토큰당 $0.25로, Fable 5의 캐시 읽기 요율의 1/4입니다. 안정적 캐시 접두부를 반복 재사용하는 긴 세션의 비용을 실질적으로 줄일 수 있습니다.

콘텐츠 출처 증명

생성된 텍스트는 Anthropic의 통계적 워터마크를 포함하며, Files API를 통해 가져온 지원 미디어에는 서명된 C2PA Content Credentials가 포함될 수 있습니다. 이러한 출처 메커니즘은 프롬프트 토큰을 추가하거나 요청 형식 변경을 요구하지 않습니다.

Claude Fable 5.1 API 사용 전 준비 사항

• 계정과 API 키: CometAPI에 로그인하여 API 키 콘솔에서 키를 발급하세요. 모델 액세스와 사용량 기반 과금 준비 상태를 테스트 호출 전 확인하세요.
• 로컬 런타임: 첫 HTTP 예제는 터미널의 curl을 사용하세요. Python 예제는 격리된 환경에 Python과 pip를 준비하고, 선택한 예제가 사용하는 SDK를 설치하세요.
• 선택한 라우트: CometAPI의 Claude Fable 5.1 API는 Messages와 Chat Completions 형식을 제공합니다. 일치하는 기본 URL과 요청 형식을 사용하고, 페이로드를 혼용하지 마세요.
• 보안 구성: COMETAPI_KEY를 커밋된 소스 파일 밖에 설정하고, 모델 ID로 claude-fable-5-1을 사용하며, 네트워크가 https://api.cometapi.com.에 접근 가능한지 확인하세요.
• 안전한 테스트와 승인 기준: 짧고 비민감한 프롬프트로 시작하세요. 응답에 사용 가능한 콘텐츠가 포함되는지 확인하고, 사용량과 완료 상태를 점검하며, 실제 문서나 로그 제출 전 조직의 데이터 처리 요구사항을 확인하세요.

CometAPI를 통해 Claude Fable 5.1에 접근하는 방법

CometAPI는 Anthropic 호환 Messages 라우트와 OpenAI 호환 Chat Completions 라우트를 통해 Claude Fable 5.1을 제공합니다. 네이티브 추론 강도, 사고, 캐싱, Claude 도구 의미론이 필요하면 Messages를, 애플리케이션이 이미 OpenAI SDK에 표준화되어 있다면 Chat Completions를 사용하세요.

1단계: API 키 저장

export COMETAPI_KEY="your-cometapi-key"

$env:COMETAPI_KEY="your-cometapi-key"

2단계: 첫 Messages 요청 보내기

curl https://api.cometapi.com/v1/messages \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-fable-5-1",
    "max_tokens": 2048,
    "messages": [{
      "role": "user",
      "content": "Review this deployment architecture and list the three highest-risk failure modes."
    }]
  }'

3단계: Anthropic Python SDK 사용

pip install anthropic

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com",
)

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=4096,
    messages=[{
        "role": "user",
        "content": "Find the root cause of this test failure and propose a verified patch.",
    }],
)

print(response.content[0].text)

4단계: OpenAI Python SDK 사용

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="claude-fable-5-1",
    messages=[{
        "role": "user",
        "content": "Design a migration plan for this service.",
    }],
)

print(response.choices[0].message.content)

Claude Fable 5.1 API의 사고는 어떻게 작동하나요?

이전 모델은 Claude Fable 5.1 사고 블록을 읽을 수 없음

Fable 5.1이 생성한 사고 블록은 이전 Claude 모델과 역호환되지 않습니다. 대화 중간에 모델을 변경한다면, 호환되지 않는 사고 블록을 제거하거나 다음 요청에 필요한 사용자 가시 메시지와 도구 결과만 유지한 채 새 브랜치를 시작하세요.

이전 턴 편집은 보존된 사고를 무효화함

보존 사고 블록은 앞선 대화 상태에 암호학적으로 결합되어 있습니다. 이전 시스템 프롬프트, 도구 정의, 사용자 메시지, 어시스턴트 응답, 도구 결과를 변경하면 해당 결합이 깨지고 사고 히스토리 오류가 발생할 수 있습니다. 재생되는 접두부는 바이트 단위로 안정적으로 유지하고, 과거를 재작성하지 말고 새 턴을 append 하세요.

턴 간 보존 사고

대화 접두부가 변하지 않으면 보존 사고는 이후 턴으로 유용한 추론 상태를 전달할 수 있습니다. 사고 블록을 원래 메시지 순서로 저장하고, 호환 모델에만 재생하며, 히스토리 편집은 기존 대화 수정이 아닌 새 브랜치로 취급하세요.

추론 강도로 사고 제어

프로덕션의 어려운 작업은 높은 추론 강도에서 시작하고, 루틴 턴에서는 낮은 설정을, 추가 능력이 비용·지연을 정당화할 때만 xhigh나 max를 사용해 보세요. 턴마다 추론 강도를 바꿀 수 있으므로, 한 대화가 단일 수준을 유지할 필요는 없습니다.

Fable 5.1은 적응형 사고만을 사용합니다. 높은 강도로 시작하고, 루틴 작업에서는 낮춘 뒤, 추가 능력이 비용과 지연을 정당화할 때만 xhigh 또는 max를 측정하세요.

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=8192,
    output_config={"effort": "high"},
    messages=[{
        "role": "user",
        "content": "Audit this repository migration plan.",
    }],
)

Claude Fable 5.1 API: 긴 응답 스트리밍, 도구 사용, 프롬프트 캐싱

다음 컨트롤을 함께 구성하세요: 추론 강도, 스트리밍, 도구 실행, 프롬프트 캐싱, 안전장치와 보존 데이터 처리. 각 요소는 장시간 요청의 관찰, 검증, 운영 방법에 영향을 줍니다.

긴 응답 스트리밍

스트리밍은 길고 높은 강도의 작업에 더 안전한 기본값입니다. 대규모 응답이 완전히 끝날 때까지 기다리지 않고 애플리케이션이 출력을 수신할 수 있기 때문입니다.

with client.messages.stream(
    model="claude-fable-5-1",
    max_tokens=8192,
    output_config={"effort": "high"},
    messages=[{
        "role": "user",
        "content": "Analyze these logs and produce a remediation plan.",
    }],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

강제 도구 선택 없이 도구 사용

Fable 5.1은 tool_choice 유형 any 또는 명명된 도구의 강제 선택을 거부합니다. 자동 선택을 사용하고, 엄격한 스키마를 적용하며, 도구 인자 검증은 애플리케이션 코드에서 수행하세요. 필수 워크플로 순서가 필요하면 tool_choice에 의존하지 말고 애플리케이션이 해당 도구를 직접 호출하거나 오케스트레이션 코드에서 필수 단계를 구현하세요.

tools = [{
    "name": "search_incidents",
    "description": "Search recent production incidents",
    "input_schema": {
        "type": "object",
        "properties": {
            "service": {"type": "string"},
            "days": {"type": "integer"},
        },
        "required": ["service", "days"],
    },
}]

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=4096,
    tools=tools,
    tool_choice={"type": "auto"},
    messages=[{
        "role": "user",
        "content": "Review checkout incidents from the last 30 days.",
    }],
)

긴 컨텍스트에 프롬프트 캐싱 사용

Anthropic은 캐시 읽기를 백만 토큰당 $0.25로 명시하며, Fable 5 요율의 1/4입니다. 안정적인 시스템 지시, 도구 스키마, 대규모 참고 자료를 동적 사용자 콘텐츠 앞에 배치하고, 사용량 메타데이터에서 캐시 히트 여부를 확인하세요.

messages = [{
    "role": "user",
    "content": [
        {
            "type": "text",
            "text": large_reference_document,
            "cache_control": {"type": "ephemeral"},
        },
        {
            "type": "text",
            "text": "Identify obligations that changed in this revision.",
        },
    ],
}]

안전장치와 데이터 보존 처리

Anthropic에 따르면 다수의 보안 관련(사이버보안·생물학) 요청은 덜 강력한 모델로 라우팅될 수 있습니다. 거부나 폴백을 애플리케이션 상태로 취급하고, 중단 사유를 기록하며, 정책이 허용하는 경우 승인된 대안으로 라우팅하세요.

또한 Fable은 기본적으로 30일 데이터 보존을 요구합니다. 합성적으로 유효한 요청을 API 형식 문제로만 디버깅하기 전에 조직의 적격성과 보존 설정을 확인하세요.

Fable 5.1 vs Opus 5 vs Sonnet 5

선정 결과: 루틴 트래픽은 Sonnet 5로 시작하고, 복잡 일반 작업은 Opus 5를 사용하며, 반복적으로 실패하거나 가장 어려운 작업만 Fable 5.1로 상향하세요. 이는 Anthropic의 권고를 따르며, 프리미엄 추론이 모든 요청의 기본 비용이 되는 것을 방지합니다.

CometAPI를 통한 가격

현재 라우트 제공 여부와 가격의 기준은 실시간 CometAPI 모델 페이지입니다. 캐싱되지 않은 입력 100,000 토큰과 출력 10,000 토큰인 요청의 단순 CometAPI 견적은 $1.20입니다. 실제 비용은 캐싱, 사고, 배치 동작, 라우팅에 따라 달라질 수 있습니다. 가격은 변경될 수 있으니 프로덕션 예산 책정 전 라이브 모델 페이지를 확인하세요.

Fable 5에서의 마이그레이션 체크리스트

1. 모델 ID를 claude-fable-5에서 claude-fable-5-1로 변경.
2. tool_choice의 any 및 명명 도구 강제 제거; auto 사용.
3. 이전 thinking-budget 가정을 output_config.effort로 대체.
4. 높은 강도에서 평가를 시작한 후 실제 작업으로 튜닝.
5. 보존 사고 블록이 있는 히스토리는 append-only 유지.
6. 장시간·고강도 실행을 위해 max_tokens 상향.
7. 사용량 메타데이터로 캐시 히트 검증.
8. 거부와 폴백을 명시적 상태로 처리.
9. 프로덕션 트레이스를 재생하고 승인된 작업률, 지연, 비용 비교.

가장 안전한 마이그레이션 전략: 히스토리는 append-only로 유지하세요. Fable 5.1은 턴 간 사고 블록을 보존할 수 있지만, 재생된 사고 블록은 앞선 대화 상태에 결합되어 있습니다. 이전 시스템 프롬프트, 도구, 메시지 변경은 해당 결합을 무효화할 수 있습니다.

일반적인 API 오류

도구 호출 변경 후 400 오류

가능한 원인: any 또는 명명 도구를 사용하는 강제 tool_choice. auto를 사용하고 필수 순서는 애플리케이션 로직에서 집행하세요.

claude-fable-5.1이 동작하지 않음

표준 ID는 하이픈을 사용합니다: claude-fable-5-1.

출력이 예상보다 빨리 끝남

effort controls how much reasoning the model performs, while max_tokens limits the response token budget. Higher effort can require more output budget, so production applications should tune both independently. Raise max_tokens where justified and stream long responses.

프롬프트 캐시가 전혀 히트하지 않음

캐시 접두부를 바이트 단위로 안정적으로 유지하세요. 타임스탬프, 도구 순서 변경, 시스템 메시지 변경은 재사용을 방해합니다.

HTTP 성공이지만 정상 응답이 없음

모든 거부를 전송 오류로 간주하지 말고, stop_reason과 폴백 메타데이터를 확인하세요.

히스토리 재생에서 사고 오류 발생

보존된 Fable 5.1 사고 블록 이전의 턴을 편집하지 마세요. append-only 히스토리 또는 현재 마이그레이션 컨트롤을 사용하세요.

프로덕션에서 Claude Fable 5.1 API를 어떻게 사용해야 하나요?

요청 라우팅, 모델 실행, 도구 실행, 검증, 평가를 분리하세요. 모델 ID, 추론 강도, 지연, 토큰 사용, 캐시 사용, 중단 사유, 폴백 동작, 최종 작업 성공 여부를 로깅하세요.

레포지토리 전반 마이그레이션, 어려운 디버깅, 장시간 에이전트, 심층 리서치, 대형 문서 종합, 더 저렴한 모델이 반복적으로 실패하는 고가치 작업에 Fable 5.1을 사용하세요. 요약, 분류, 추출, 짧은 고객 응대에는 기본값으로 피하세요.

예시: 체크아웃 인시던트 조사

팀은 비식별 처리된 체크아웃 오류, 최근 배포 변경, 관련 런북을 제공할 수 있습니다. 애플리케이션은 해당 인시던트 레코드를 검색한 뒤, 모델에 가능한 원인을 순위화하고 각 가설을 증거와 연결하도록 요청합니다. 엔지니어는 제안된 진단 단계를 검토하고 합성 트랜잭션을 사용하는 샌드박스에서 테스트를 승인합니다. 승인 기준은 재현 가능한 동작, 추적 가능한 증거, 회귀 검사 통과이며, 프로덕션 완화 조치는 별도의 사람 승인에 따릅니다.

예시: 운영 요구사항 변경 분석

팀은 승인된 운영 매뉴얼, 지원 정책, 개정 초안을 제공할 수 있습니다. 변하지 않은 참고 자료는 안정적 컨텍스트로 유지한 뒤, 변경된 의무, 담당 팀, 마감, 예외를 비교하도록 모델에 요청하세요. 제안된 각 발견은 양쪽 버전에서 해당 구절을 인용하고, 명시적 변경과 불확실한 해석을 구분해야 합니다. 승인 기준은 검토자가 보고된 모든 변경을 인용 증거와 대조 확인하는 것입니다. 절차 업데이트나 영향 팀 통지는 그 후에 진행합니다.

결론

Claude Fable 5.1은 단순한 모델 문자열 교체가 아닙니다. 강제 도구 동작, 사고 히스토리 규칙, 추론 강도 컨트롤, 캐시 경제성, 장기 실행 진행 기능은 신중한 마이그레이션을 요구합니다.

가장 효과적인 배포는 루틴 볼륨에는 Claude Sonnet 5, 기본 복잡 작업에는 Claude Opus 5, 그리고 Claude Fable 5.1은 필요한 경우에만 능력을 상향하는 방식입니다. 승인된 작업 완료율이 총비용과 지연을 정당화할 만큼 개선될 때만 적용 범위를 확대하세요.