Claude Fable 5.2 API 키 발급·사용법: 전용 키 없음, 첫 호출과 오류 해결

2026년 11월 12일 기준으로 Claude(클로드) Fable 5.2만 부르는 전용 API 키나 별도 신청 절차는 없습니다. Claude Console(platform.claude.com)에서 발급한 일반 API 키 하나로 조직이 쓸 수 있는 모든 모델을 호출하고, 어떤 모델을 쓸지는 요청 본문의 model 값으로 정합니다. 그러니 할 일은 키를 만들어 "model": "claude-fable-5-2"로 한 번 호출해 보는 것입니다. 인증 심사가 필요한 것은 같은 사양의 Claude Mythos 5.2 쪽이고, Fable 5.2는 신청 없이 쓸 수 있습니다.

키가 있는데도 호출이 막힌다면 원인은 대개 키가 아니라 키가 속한 조직에 있습니다. 선불 크레딧이 남아 있어야 하고, 조직이 제로 데이터 보존(ZDR)이 아닌 30일 데이터 보존 상태여야 하며, 사용량 티어의 요청·지출 한도 안에 있어야 합니다. 한국은 Anthropic의 API 지원 지역에 들어 있습니다. Claude Pro·Max·Ultra 구독료가 API 비용을 대신 내 주지는 않으며, 예외는 Max·Ultra·Team 요금제에 포함된 월 API 크레딧뿐입니다.

호출이 성공했는지는 응답에서 바로 확인합니다. HTTP 200이 오고 응답의 model이 claude-fable-5-2이며 usage에 토큰 수가 찍혀 있으면 됩니다. 2026년 11월 12일 키 없이 api.anthropic.com에 Fable 5.2 요청을 보냈을 때는 모델 이름을 따지기도 전에 401 x-api-key header is required가 돌아왔으므로, 401이 나오면 다른 설정보다 키부터 확인하면 됩니다.

Claude Console에서 API 키 발급하는 순서

API 키는 Claude Console의 API 키 페이지에서 만들며, 키를 만들 때 모델을 고르는 단계는 없습니다. 순서와 버튼 이름은 Anthropic의 Claude API 키 발급 문서(Get your API key)에 적힌 그대로입니다.

1. platform.claude.com에 로그인하거나 계정을 만듭니다.
2. API 키 페이지 platform.claude.com/settings/keys를 엽니다.
3. Create key를 누르고 키 이름과 만료 기간을 정한 뒤, Linked account를 본인 또는 서비스 계정으로 지정합니다. 필요하면 워크스페이스를 골라 키가 쓰일 범위를 좁힙니다.
4. 화면에 한 번만 표시되는 전체 키(sk-ant-로 시작)를 복사해 비밀번호 관리 도구 같은 안전한 곳에 저장합니다.
5. 터미널에서 export ANTHROPIC_API_KEY="sk-ant-..."처럼 환경 변수로 지정합니다. Anthropic SDK와 ant CLI는 이 변수를 자동으로 읽습니다.

Create key 버튼이 비활성화되어 있다면 현재 역할에 키 생성 권한이 없다는 뜻이므로, 조직 관리자에게 역할 변경이나 서비스 계정 키 발급을 요청해야 합니다. 키를 잃어버리면 Console에서 다시 볼 수 없으니 새 키를 만들면 됩니다. 개인 키는 본인 자격으로 동작해 조직을 떠나면 멈추기 때문에, CI나 서버처럼 계속 돌아가야 하는 작업에는 서비스 계정 키가 맞습니다. 로컬에서 시험만 해 볼 때는 키 대신 ant auth login으로 CLI에 로그인하는 방법도 Claude API 빠른 시작 문서가 안내합니다.

키 말고 조직이 갖춰야 할 조건: 크레딧·데이터 보존·티어·지역

Fable 5.2를 호출할 수 있는지는 키보다 키가 속한 조직 설정으로 정해집니다. 크레딧 잔액, 데이터 보존 설정, 요청 한도와 월 지출 한도가 모두 키 단위가 아니라 조직(데이터 보존은 워크스페이스 단위도 포함) 단위로 걸리기 때문에, 막혔을 때 새 키를 만들어도 결과는 같습니다. 2026년 11월 12일 기준 Anthropic 문서에 적힌 조건을 확인 위치와 함께 정리하면 다음과 같습니다.

크레딧은 Claude API 결제 도움말에 따라 선불로 사며, 처음 구매할 때 Console이 조직과 사용 목적을 묻습니다. 산 크레딧은 바로 쓸 수 있고 구매일로부터 1년 뒤 만료되며 환불되지 않습니다. 실패한 요청은 과금되지 않지만, 성공하던 요청이 클라이언트 쪽 연결 끊김이나 타임아웃으로 중간에 끊기면 과금됩니다. 최소 구매 금액은 이 도움말에 나와 있지 않으므로 Billing 화면에 표시되는 값을 기준으로 합니다.

요청 한도는 Anthropic 요청 한도 문서(Rate limits)의 사용량 티어로 정해집니다. 새 조직은 표준보다 낮은 한도의 Evaluation 티어에서 시작할 수 있는데, 그 수치는 공개되어 있지 않아 자기 조직 값은 platform.claude.com/usage/limits에서 봐야 합니다. 표준 Start 티어에서 Fable 5.2는 분당 요청 4,000회, 입력 토큰 500,000개, 출력 토큰 100,000개이고, Fable 5.1·Fable 5가 함께 쓰는 한도와는 따로 계산됩니다. 티어별 월 지출 한도는 Start $500, Build $1,000, Scale $200,000이며, 더 필요하면 Rate limits 페이지의 Request tier increase로 요청합니다. 다음 티어로 올라가는 데 필요한 크레딧 금액은 문서에 없고, 예전 자료에 나오는 Tier 1~4는 지금의 Evaluation / Start / Build / Scale 이전 이름입니다.

데이터 보존 조건은 대부분의 개인 개발자에게는 해당하지 않습니다. Anthropic의 API 데이터 보존 문서는 Fable 5.2를 30일 데이터 보존이 필요한 모델로 지정하고, ZDR 조직에서는 Anthropic이 따로 승인하지 않는 한 쓸 수 없다고 적고 있습니다. 새로 만든 기본 조직은 ZDR이 아니므로, 이 조건은 회사가 ZDR 계약을 맺은 조직이나 워크스페이스에서 키를 받은 경우에 확인하면 됩니다.

구독료로 API를 쓸 수 있나: Max·Ultra·Team의 월 API 크레딧만 해당

Claude Pro·Max·Ultra 구독료는 API 호출 비용을 대신 내 주지 않습니다. Anthropic의 Claude Fable 모델과 요금제 도움말에 따르면 Claude API에서 Fable을 쓰면 구독과 별도로 표준 API 요금이 청구됩니다. 예외는 Max, Ultra, Team 요금제에 포함된 월 API 크레딧으로, Max는 $100, Ultra는 $200, Team은 Standard 좌석당 $20·Premium 좌석당 $100(조직 합산 월 $500 상한)입니다. Free, Pro, Enterprise는 받을 수 없습니다.

월 API 크레딧은 월 API 크레딧 도움말에 적힌 대로 요금제를 7일 이상 쓴 뒤 claude.ai > Settings > Billing > API credits > Link organization에서 Console 조직 하나에 연결해 받습니다. 결제 수단을 등록하지 않아도 되고, 구매한 크레딧보다 먼저 차감되며, 남은 금액은 결제 주기마다 사라집니다. 사용 가능한 모든 Claude 모델의 Messages·Batches API, Playground, Managed Agents, Agent SDK에 쓸 수 있으므로 Fable 5.2 호출에도 쓰이지만, 대화형 Claude Code와 앱의 추가 사용량에는 쓸 수 없습니다.

완전히 무료로 시작하는 방법은 사실상 신규 사용자 크레딧 하나입니다. Claude API 가격 페이지는 신규 사용자에게 API를 시험할 무료 크레딧을 준다고만 적고 금액은 밝히지 않으며, 그 크레딧으로 Fable 5.2를 호출할 수 있는지도 따로 설명하지 않습니다. 영상이나 게이트웨이 홍보에서 말하는 '무료 Fable 키'는 해당 서비스가 자체적으로 주는 크레딧이지 Anthropic 크레딧이 아닙니다. 결제와 무료 크레딧을 더 자세히 보려면 Claude API 키 구매 가이드: 공식 결제·키 발급·무료 크레딧·가격 확인법을 참고하세요.

앱에서 Fable 5.2를 쓰는 것은 API와 별개입니다. Pro 사용자는 출시 기념으로 2026년 11월 16일 오후 11시 59분(PT)까지 1주일 동안 앱에서 Fable을 쓸 수 있지만, 이것으로 API 키나 API 크레딧이 생기지는 않습니다. 앱 쪽 한도와 추가 요금은 Claude Fable 5.1 사용량 제한: Pro·Max 한도와 추가 요금에서 다룹니다.

첫 호출: model에 claude-fable-5-2를 넣고 응답의 model·usage 확인

첫 호출은 Claude API 빠른 시작 문서의 cURL 예시에서 model만 claude-fable-5-2로 바꾸면 됩니다. 엔드포인트는 https://api.anthropic.com/v1/messages이고, 헤더에 x-api-key, anthropic-version: 2026-10-21, content-type을 넣습니다. temperature나 thinking: {"type": "disabled"}는 Fable 5.2가 거부하는 필드이므로 넣지 않습니다.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 2048,
    "messages": [
      {"role": "user", "content": "Reply with exactly: ready. Then on a new line give 17 * 23."}
    ]
  }'

Python에서는 pip install anthropic으로 SDK를 설치한 뒤 다음처럼 호출하고, 응답의 모델과 토큰 수를 함께 출력해 둡니다.

import anthropic

client = anthropic.Anthropic()  # ANTHROPIC_API_KEY 환경 변수를 읽습니다

message = client.messages.create(
    model="claude-fable-5-2",
    max_tokens=2048,
    messages=[
        {"role": "user", "content": "Reply with exactly: ready. Then on a new line give 17 * 23."}
    ],
)
print(message.model, message.stop_reason)
print(message.usage.input_tokens, message.usage.output_tokens)

API 키 발급 문서는 직접 HTTP 요청을 보낼 때 Authorization: Bearer <키> 형식도 안내하므로, 두 형식 모두 현재 문서에 있습니다. 예전 튜토리얼에는 anthropic-version: 2023-06-01이 많이 남아 있는데, 키가 틀린 요청에서는 두 버전 값 모두 같은 401이 돌아왔을 뿐이라 정상 키에서도 똑같이 동작한다는 뜻은 아닙니다. 새로 작성하는 코드에는 문서의 2026-10-21을 씁니다.

같은 프롬프트를 2026년 11월 12일 laozhang.ai 게이트웨이의 Anthropic Messages 형식 엔드포인트로 보냈을 때는 5.53초 만에 HTTP 200이 왔습니다. 응답의 model은 claude-fable-5-2, stop_reason은 end_turn이었고, 내용은 thinking 블록과 text 블록("ready / 391") 두 개, usage는 입력 33토큰·출력 16토큰이었습니다. Fable 5.2 정가는 100만 토큰당 입력 $8·출력 $40이므로 이 호출의 정가 기준 비용은 33 × $8/1M + 16 × $40/1M ≈ $0.0009입니다. 이 시간과 토큰 수는 게이트웨이를 거친 한 번의 호출에서 나온 값이라 api.anthropic.com의 응답과 같다고 볼 수는 없지만, 성공 여부를 판단하는 model, stop_reason, usage 필드는 공식 응답에도 똑같이 들어 있습니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

요청에 thinking 필드를 넣지 않았는데 thinking 블록이 온 것은 Fable 5.2에서 적응형 사고(adaptive thinking)가 항상 켜져 있고 API 기본 effort가 high이기 때문입니다. 짧은 답만 필요하면 본문에 다음 두 필드를 더해 effort를 낮춥니다. 같은 날 같은 경로에서 effort low는 3.07초, text 블록만, 출력 6토큰이었고, high는 3.57초, thinking + text, 출력 16토큰이었습니다. effort 값은 low, medium, high, xhigh, max 중에서 고릅니다.

"thinking": {"type": "adaptive"},
"output_config": {"effort": "low"}

effort별 품질과 비용 차이는 Claude Fable 5.2 vs Opus 5.5 비교: 실측 비용 1.86배와 effort 고르는 법에서 다룹니다.

Fable 5.2 API 오류 메시지별 원인과 해결

호출이 실패하면 HTTP 상태 코드와 응답의 error.type, message만 보고도 빠진 조건을 찾을 수 있습니다. 아래 표에서 401 두 줄은 2026년 11월 12일 api.anthropic.com에 직접 보내 받은 응답이고, 나머지는 Anthropic API 오류 문서, 요청 한도 문서, Fable 5.2 변경 사항 문서(What's new in Claude Fable 5.2)에 적힌 동작입니다.

401 두 줄의 조건은 이렇습니다. 2026년 11월 12일 한 대의 기기에서 model: claude-fable-5-2 요청을 키 헤더 없이 보내자 x-api-key header is required가, 임의로 만든 가짜 키를 넣자 invalid x-api-key가 왔고, 가짜 키 요청은 anthropic-version을 2023-06-01로 보내든 2026-10-21로 보내든, GET /v1/models로 보내든 같은 401이었습니다. 버전 헤더와 엔드포인트를 바꿔도 같은 401이 모두 1초 안에 왔으므로, 키 검사가 모델 이름·버전 헤더·본문 검사보다 먼저 이루어집니다. 정상 키인데 크레딧이 없는 조직이 어떤 응답을 받는지는 이 시험으로 알 수 없었습니다.

마지막 줄의 거절은 오류처럼 보이지 않는다는 점에 주의해야 합니다. HTTP 200이 오고 stop_reason이 refusal이며 stop_details 객체가 붙기 때문에, 상태 코드만 보는 코드는 성공으로 처리합니다. Fable 5.2의 거절을 다른 모델로 다시 보낼 때 허용되는 대상은 Claude Opus 4.8과 Claude Opus 5입니다.

게이트웨이 키로 호출할 때: model·usage와 요청 형태를 확인

여러 API 게이트웨이가 claude-fable-5-2를 제공한다고 홍보하지만, 그곳에서 받는 키는 각 서비스의 키이지 Anthropic의 sk-ant- 키가 아닙니다. 잔액, 한도, 지원하는 기능이 서비스마다 다르고, 광고하는 할인율은 각 서비스의 주장일 뿐이므로 직접 확인할 대상입니다. 확인할 수 있는 것은 응답의 model이 claude-fable-5-2인지, 그리고 usage의 토큰 수에 Anthropic 정가를 곱한 값과 실제 차감액이 맞는지입니다. 다만 model은 그 서비스가 적어 보내는 값이라, 이것만으로 상위 모델이 무엇인지 증명되지는 않습니다.

laozhang.ai도 그런 경로 중 하나입니다. 2026년 11월 10일부터 claude-fable-5-2를 공식 정가와 같은 단가로 제공하며, laozhang.ai Claude 호출 문서에 따르면 Anthropic Messages 형식은 https://api.laozhang.ai/v1/messages에 Claude Code 그룹 토큰으로, OpenAI 호환 형식은 /v1/chat/completions에 default 그룹 토큰으로 호출합니다. 공식 API와 달리 한 번의 응답 출력이 32,768토큰으로 제한되고, web_search·web_fetch·code_execution 같은 Anthropic 서버 도구, /v1/messages/count_tokens, Message Batches, Files 엔드포인트가 없고, 문서에 fast mode도 없습니다. 가격이 같으므로 비용을 줄이는 방법이 아니라, Console 결제와 조직 조건을 따로 맞추기 어렵거나 OpenAI 호환 형식 하나로 여러 모델을 부르려는 경우에 고려할 선택지입니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

2026년 11월 12일 이 게이트웨이에서 확인한 내용은 다음과 같습니다. GET /v1/models는 207개 모델을 돌려줬고 그중 Claude 모델 11개에 claude-fable-5-2가 있었으며, OpenAI 호환 형식 호출도 3.27초 만에 HTTP 200, model: claude-fable-5-2, 입력 33·출력 16토큰으로 Messages 형식과 같은 수치가 나왔습니다. 문서는 Messages 형식에 Claude Code 그룹 토큰을 쓰라고 하지만, 이날은 default 그룹 토큰으로도 Fable 5.2 Messages 호출이 됐습니다.

오류 응답은 Anthropic과 다릅니다. 같은 날 claude-fable-5.2, fable-5-2, Bedrock용 ID global.anthropic.claude-fable-5-2, claude-fable-5-2-latest를 넣으면 404가 아니라 503 api_error와 함께 "Current group default has no available channels for model …" 메시지가 왔고, 가짜 토큰은 401 authentication_error, "Invalid token."이었습니다. 요청 형태도 더 너그러워서, Anthropic 문서상 400이어야 할 thinking: {"type": "disabled"}와 temperature: 0.2가 HTTP 200으로 통과했습니다. 그런데 disabled를 보낸 응답에도 thinking 블록이 그대로 있었고, tool_choice: {"type": "any"}만 400이었습니다. 그래서 게이트웨이에서 잘 돌던 코드도 api.anthropic.com으로 옮기면 400을 받을 수 있으니, 옮기기 전에 thinking: disabled와 temperature를 지워야 합니다.

Bedrock·Google Cloud·Foundry에서 쓰는 Fable 5.2 모델 ID

이미 AWS, Google Cloud, Microsoft Azure를 쓰고 있다면 Console 키 없이 그 클라우드 계정으로 Fable 5.2를 호출할 수 있고, 청구와 요청 한도도 각 클라우드 계정을 따릅니다. 모델 ID는 Amazon Bedrock만 다르고 나머지는 claude-fable-5-2 그대로입니다. 2026년 11월 12일 기준 Fable 5.2 변경 사항 문서의 제공처는 다음과 같습니다.

안내: laozhang.ai는 이 블로그 운영팀의 자사 서비스입니다. 그 가격은 독립적인 비교가 아니라 자사 제시 가격입니다.

한국에서 Bedrock을 쓰는 경우에는 추론 프로필을 확인해야 합니다. Bedrock용 Claude 문서에 따르면 Fable 5.2의 추론 프로필은 global과 us에만 있고 eu, jp, apac에는 없으므로, 한국에서 호출하더라도 apac.이 아니라 global.이나 us.로 시작하는 ID를 골라야 합니다. 기본 모델 ID는 anthropic.claude-fable-5-2이며 요청은 bedrock-runtime 엔드포인트로만 보냅니다.

Claude Code에서 Fable 5.2를 API 키로 쓰려면: 2.1.321 이상

Claude Code에서 Fable 5.2를 쓰려면 2.1.321 이상이 필요하며, /model fable 또는 claude --model claude-fable-5-2로 고릅니다. ANTHROPIC_API_KEY로 인증해 쓰면 Claude Code는 구독이 아니라 그 키의 Console 조직에 API 요금으로 청구합니다. 키와 구독 중 어디로 청구되는지는 Claude Code API 키와 구독 결제: 키를 승인하면 API 과금, -p는 항상 키에 정리되어 있습니다.

버전 차이는 2026년 11월 10일 로컬 모의 서버로 Claude Code가 실제로 보내는 요청을 기록해 확인했습니다. 2.1.321은 fable과 claude-fable-5-2를 모두 claude-fable-5-2로 보냈고(effort medium, max_tokens 128000), 2.1.316은 fable을 claude-fable-5-1로 바꿔 보냈으며 claude-fable-5-2를 지정하면 "Claude Code doesn't recognize the model … assumes a context window of 200k tokens" 경고와 함께 max_tokens 32000으로 보냈습니다. 같은 기기의 claude --version은 2026년 11월 12일에도 2.1.316이었으므로, 자동 업데이트를 믿기보다 버전을 직접 확인하는 편이 안전합니다. 모의 서버 시험은 클라이언트가 보내는 값을 보여 줄 뿐 Anthropic의 응답은 포함하지 않습니다. effort 기본값과 바꾸는 방법은 Claude Code effort 설정과 차이: Opus 5.5 기본값 medium, 안 먹힐 때 해결을 참고하세요.

Claude Fable 5.2 API 자주 묻는 질문

Fable 5.2 API 가격은 얼마이고 Opus 5.5와 어떻게 고르나요?

2026년 11월 12일 기준 Fable 5.2 모델 개요의 정가는 앞서 계산에 쓴 입력 $8·출력 $40(100만 토큰당)으로, Fable 5.1의 $10·$50보다 낮습니다. 다만 effort가 높아질수록 출력 토큰이 늘어 작업당 비용은 달라집니다. 5.1과의 작업당 비용은 Claude Fable 5.2 vs 5.1 차이: low·medium은 더 싸고 high부터 비싸다, Opus 5.5와의 선택은 Claude Fable 5.2 vs Opus 5.5 비교: 실측 비용 1.86배와 effort 고르는 법에서 비교합니다.

Batch API나 프롬프트 캐싱으로 Fable 5.2 비용을 줄일 수 있나요?

줄일 수 있습니다. Anthropic 정가 기준으로 Fable 5.2의 Batch API는 50% 할인된 입력 $4·출력 $20이고, 캐시 읽기는 100만 토큰당 $0.20이며 분당 입력 토큰 한도에도 들어가지 않습니다. 둘 중 어느 쪽이 더 아끼는지는 Claude Batch API 가격: 50% 할인보다 캐싱이 더 아끼는 경우와 Claude(클로드) 프롬프트 캐싱 적용법: 캐시 읽기 0.05배, 최소 512토큰을 참고하세요.

Fable 5.2 API는 언제까지 쓸 수 있나요?

2026년 11월 12일 기준 Anthropic은 Fable 5.2를 현재 최신 모델(active)로 표시하고, 지원 종료 시점은 2027년 11월 9일 이전이 아니라고 밝히고 있습니다. 출시일은 2026년 11월 9일이고, 1M 토큰 컨텍스트와 최대 128K 출력 토큰을 지원합니다.