Как использовать Claude Fable 5 API (с Python)

TL;DR

• Вызывайте Claude Fable 5 через Anthropic Messages API с model ID claude-fable-5 — установите SDK anthropic, задайте ANTHROPIC_API_KEY и отправьте запрос messages.create
• Подвох: код, написанный для старых моделей Claude (или GPT), ломается на Fable 5. temperature, top_p, top_k, budget_tokens, thinking: {type:"disabled"} и prefill ответа ассистента — всё возвращает 400
• Thinking всегда включён — глубину регулируйте через output_config.effort (low → max), а не через token budget. Обрабатывайте stop reason refusal и включайте fallbacks
• Fable 5 требует 30-дневного хранения данных (организации с ZDR получают 400 на каждый запрос) и стоит $10 / $50 за 1M input/output токенов — примерно в 2× дороже Opus 4.8
• Хотите обойтись без аккаунта Anthropic, tier и настройки retention? Вызывайте claude-fable-5 через OpenAI-совместимый endpoint Velokey с одним ключом — та же цена $10/$50, без параметрических ловушек ниже

Большинство гайдов «как вызвать API» показывают трёхстрочный hello-world и на этом останавливаются. Этого хватает, пока Fable 5 не вернёт 400 на первый же реальный запрос, потому что вы по привычке передали temperature, или пока ваш код читает response.content[0] и падает на refusal. Fable 5 — самая мощная модель Anthropic, но у неё более строгая поверхность запроса, чем у всего, что было раньше. Ниже — рабочий вызов, а затем пять вещей, которые реально сломают вашу интеграцию.

Что нужно, чтобы вызвать Claude Fable 5 API?

Нужен платный аккаунт Anthropic, SDK anthropic и — вот это многих подводит — настройка хранения данных организации не менее 30 дней. Fable 5 недоступна при zero data retention (ZDR); организация с ZDR получает 400 invalid_request_error на каждый запрос к Fable 5, каким бы чистым ни был payload.

Model ID — claude-fable-5. У модели контекстное окно 1M токенов (и по умолчанию, и максимум) и до 128K output-токенов. Установка и аутентификация:

pip install anthropic
export ANTHROPIC_API_KEY="sk-ant-..."   # never hardcode

Перед первым вызовом убедитесь:

Как сделать первый вызов Claude Fable 5 API?

Вызывайте client.messages.create() с model="claude-fable-5" и списком messages. Не передавайте параметр thinking — thinking всегда включён — и регулируйте глубину рассуждения через output_config.effort.

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

response = client.messages.create(
    model="claude-fable-5",
    max_tokens=16000,
    output_config={"effort": "high"},   # low | medium | high | xhigh | max
    messages=[
        {"role": "user", "content": "Explain the tradeoffs of event sourcing in two paragraphs."}
    ],
)

# Always check stop_reason before reading content (see refusals below)
if response.stop_reason != "refusal":
    for block in response.content:
        if block.type == "text":
            print(block.text)

Это и есть весь hello-world. effort — главный регулятор качества/латентности: high — хороший default, xhigh — оптимальная точка для кодинга и agentic-задач, а low/medium подходят для рутинных задач и часто обходят топовые настройки более старых моделей. Сырая цепочка рассуждений никогда не возвращается; если нужен читаемый summary рассуждений, передайте thinking={"type": "adaptive", "display": "summarized"}.

Как вызвать Claude Fable 5 через Velokey (без аккаунта Anthropic)?

Если не хотите возиться с аккаунтом Anthropic, usage tier и требованием 30-дневного retention, вызывайте Fable 5 через OpenAI-совместимый endpoint [Velokey](/model/claude-fable-5). Направьте любой OpenAI-клиент на base URL Velokey, подставьте ключ Velokey и укажите модель claude-fable-5 — это стандартный chat completion, поэтому параметрические ловушки из следующего раздела не применяются.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.velokey.ai/v1",
    api_key="sk-velokey-...",   # your Velokey key — not an Anthropic key
)

response = client.chat.completions.create(
    model="claude-fable-5",
    messages=[{"role": "user", "content": "Explain the tradeoffs of event sourcing in two paragraphs."}],
)
print(response.choices[0].message.content)

Та же цена $10 / $50 за 1M, что и при прямом вызове Anthropic, списание с кредитов Velokey, один ключ на все модели — и без Anthropic-специфичной настройки. Это самый быстрый путь к рабочему вызову Fable 5. Остальная часть гайда описывает прямой маршрут через Anthropic и особенности запросов, которые OpenAI-совместимый endpoint сглаживает.

Что ломается, если вызывать Claude Fable 5 как старую модель?

При прямом вызове Anthropic пять параметров запроса, которые работали на старых моделях Claude или GPT, теперь возвращают 400 на Fable 5. Именно из-за этого «быстрая замена» превращается в полдень отладки (и именно этого трения избегает путь через Velokey выше).

Параметры, которые дают 400 на Fable 5:

*Источник: документация Anthropic Claude Fable 5 API, 2026.*

Ментальная модель: Fable 5 намеренно убрала sampling-ручки и фиксированный thinking budget. Нет temperature=0 для детерминизма и нет потолка budget_tokens — поведение задаётся промптом, а глубина ограничивается через effort. Если вы мигрируете рабочую интеграцию Opus или GPT, сначала удалите эти параметры — и только потом трогайте всё остальное.

Как обрабатывать отказы Claude Fable 5?

Fable 5 запускает safety-классификаторы, которые могут отклонить запрос — и отклонение это не HTTP-ошибка. Возвращается успешный 200 с stop_reason: "refusal" и пустым (или частичным, mid-stream) массивом content. Код, который безусловно читает response.content[0].text, на этом упадёт.

Нужно сделать две вещи. Во-первых, всегда ветвитесь по stop_reason до чтения content. Во-вторых, включите fallbacks, чтобы ложноположительный отказ не просто валил запрос — безобидная работа в security tooling или life-sciences тоже может сработать на классификаторе, так что это важно даже для легитимных приложений:

response = client.beta.messages.create(
    model="claude-fable-5",
    max_tokens=16000,
    betas=["server-side-fallback-2026-06-01"],
    fallbacks=[{"model": "claude-opus-4-8"}],   # re-served in the same call on a decline
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)

if response.stop_reason == "refusal":
    # The whole chain (Fable 5 + fallback) declined — surface it, don't retry as-is
    handle_refusal(response)
else:
    print(next(b.text for b in response.content if b.type == "text"))

С server-side параметром fallbacks отклонённый запрос прозрачно перезапускается на claude-opus-4-8 внутри того же вызова, а биллинг корректируется, чтобы вас не списали дважды. Отказ до любого output не тарифицируется вообще. Включайте это по умолчанию в новом коде для Fable 5 — это opt-in, поэтому без него refusal просто останавливает запрос.

Сколько стоит Claude Fable 5 API?

Fable 5 стоит $10 за 1M input-токенов и $50 за 1M output-токенов — примерно в 2× дороже Claude Opus 4.8 ($5 / $25). Модель рассчитана на самые сложные рассуждения и long-horizon agentic-работу, а не на high-volume повседневные вызовы.

Сколько стоит один запрос:

*Потокенный расчёт по опубликованным тарифам. Fable 5: 10K×$10/1M + 2K×$50/1M = $0.20.*

Два рычага помогают держать счёт под контролем. Опускайте effort до medium или low на рутинных задачах — Fable 5 на low effort часто догоняет старые модели на их потолке. И используйте [prompt caching](/blog/claude-api-pricing-2026) для повторяющегося контекста; cached reads тарифицируются примерно в десятую часть от input rate. Ещё одна операционная деталь: отдельные запросы на сложных задачах могут идти несколько минут, поэтому стримьте всё с большим max_tokens, чтобы избежать client timeout:

with client.messages.stream(
    model="claude-fable-5",
    max_tokens=64000,
    output_config={"effort": "xhigh"},
    messages=[{"role": "user", "content": "..."}],
) as stream:
    message = stream.get_final_message()

Если не хотите сами управлять аккаунтом Anthropic и настройками 30-дневного retention, единый gateway вроде [Velokey](/model/claude-fable-5) отдаёт claude-fable-5 через один OpenAI-совместимый endpoint рядом с другими моделями — вы вызываете его тем же ключом, что и всё остальное. О том, как Fable 5 сравнивается по цене с другими frontier-моделями, см. наш гайд по ценам Claude API, разбор тиров GPT-5.6 и сравнение GLM-5.2 vs GPT-5.5 vs Opus 4.8.

Frequently Asked Questions

Какой model ID у Claude Fable 5 API?

Model ID — claude-fable-5 — точная строка, без суффикса даты. Это самая мощная широко доступная модель Anthropic с контекстным окном 1M токенов (и default, и максимум) и до 128K output-токенов. Вызывайте её через Messages API (client.messages.create) с официальным SDK anthropic.

Почему мой запрос к Claude Fable 5 возвращает 400?

Обычные причины — параметры, которые Fable 5 убрала: temperature, top_p, top_k, thinking: {budget_tokens}, thinking: {type:"disabled"} или prefill хода ассистента — каждый даёт 400. Отдельная причина — организация с zero data retention, которая получает 400 на каждый запрос к Fable 5. Уберите sampling/thinking-параметры и проверьте retention ≥ 30 дней.

Как управлять глубиной thinking на Claude Fable 5?

Используйте output_config.effort — low, medium, high, xhigh или max. Thinking всегда включён и его нельзя отключить или задать фиксированный budget_tokens (оба варианта дают 400). high — надёжный default; xhigh подходит для кодинга и agentic-задач. Чтобы увидеть summary рассуждений, добавьте thinking={"type":"adaptive","display":"summarized"}.

Сколько стоит Claude Fable 5 API?

$10 за 1M input-токенов и $50 за 1M output-токенов — примерно в 2× дороже Claude Opus 4.8. Запрос на 10K input / 2K output обходится примерно в $0.20. Снижение effort и prompt caching (cached reads тарифицируются ~10% от input) — основные способы сократить расходы на high-volume работе.

Как обработать refusal Claude Fable 5?

Проверяйте response.stop_reason до чтения content — refusal возвращает HTTP 200 с stop_reason: "refusal" и пустым или частичным content. Включите server-side параметр fallbacks (с betas=["server-side-fallback-2026-06-01"]), чтобы отказ переобслуживался на claude-opus-4-8 в том же вызове, а не падал.

Можно ли использовать Claude Fable 5 API без аккаунта Anthropic?

Напрямую — нет: Fable 5 требует платный аккаунт Anthropic с 30-дневным хранением данных. До неё можно добраться через unified API gateway, который берёт на себя upstream-доступ к Anthropic, так что вы вызываете claude-fable-5 через один OpenAI-совместимый endpoint без управления аккаунтом и настройками retention.

Нужен Claude Fable 5 без управления аккаунтом Anthropic? [Получите API-ключ Velokey](/model/claude-fable-5) и вызывайте claude-fable-5 через один OpenAI-совместимый endpoint — тот же ключ, рядом со всеми остальными моделями.

*Последнее обновление: 13 июля 2026. Детали API взяты из документации Anthropic Claude Fable 5 на момент написания. Цены, параметры и поведение модели задаются Anthropic и могут измениться — сверяйтесь с официальной документацией перед выводом в production.*