Claude Fable 5.1 через API: подключение, цена и контроль расхода

Claude Fable 5.1 есть в каталоге Zukko, но это одна из самых дорогих моделей: $3.48 за миллион входных токенов и $17.4 за миллион выходных. Если вы ищете, как подключить claude fable 5.1 через api и не получить неожиданное списание, ниже — адреса и рабочий код, расчёт стоимости запроса, работа с кэшем и настройка ключа с лимитом и списком разрешённых моделей.

Цена Claude Fable 5.1 и место в каталоге

Сначала цифры, чтобы было понятно, с чем мы имеем дело. Цены — в долларах за 1M токенов, на 2026-10-06.

У GPT запись в кэш отдельно не списывается: первый запрос целиком идёт по цене входа.

Официальная цена вендора за Fable 5.1 — $10 / $50, в Zukko — $3.48 / $17.4. Но внутри каталога картина другая: индекс силы (Intelligence Index от Artificial Analysis, сводный балл по бенчмаркам) у Fable 5.1 равен 53. Это ниже, чем у Opus 5.5 (58), и столько же, сколько у GPT-6 Astra, при этом Fable дороже обеих.

Индекс — усреднённая оценка, он не говорит, как модель справится именно с вашей задачей. Но выбирать Fable 5.1 «по умолчанию, потому что дорогая — значит сильная» цифры не позволяют. Её стоит брать осознанно, после проверки.

Актуальный список и цены — GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете.

Как подключить Claude Fable 5.1 через API

Модель доступна в обоих форматах: OpenAI-совместимом и Anthropic. Ключ один — fetch_..., создаётся в кабинете.

OpenAI-совместимый формат

Base URL — https://api.zukko.pro/v1, эндпоинт POST /v1/chat/completions:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-1",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "Найди три слабых места в этом плане запуска: ..."}]
  }'

Так удобно подключать готовые приложения на OpenAI SDK. Минус для Fable существенный: в OpenAI-формате весь вход Claude-моделей идёт по цене входа, скидки за кэш нет.

Anthropic-формат с кэшем

Для длинных повторяющихся контекстов используйте POST https://api.zukko.pro/v1/messages — там шлюз видит, сколько входа пришло из кэша, и считает его по цене чтения кэша. Официальный Anthropic SDK сам добавляет /v1, поэтому base URL указывается без него:

from anthropic import Anthropic

client = Anthropic(base_url="https://api.zukko.pro", api_key="fetch_ваш_ключ")

contract = open("contract.txt", encoding="utf-8").read()

resp = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=2000,
    system=[
        {"type": "text", "text": "Ты аналитик договоров. Отвечай только по тексту договора."},
        {"type": "text", "text": contract, "cache_control": {"type": "ephemeral"}},
    ],
    messages=[{"role": "user", "content": "Какие пункты позволяют расторгнуть договор в одностороннем порядке?"}],

Блок с cache_control помечает текст договора для кэширования. Повторные вопросы по тому же договору будут читать его из кэша. Подробнее о формате — в документации по /v1/messages↗.

Claude Code

export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_ваш_ключ
export ANTHROPIC_MODEL=claude-fable-5-1
claude

Обратите внимание: переменная именно ANTHROPIC_AUTH_TOKEN, а адрес без /v1. Пошагово — в инструкции по Claude Code↗. Агентная сессия на каждом шаге отправляет модели весь накопленный контекст, поэтому держать Fable основной моделью в Claude Code дорого. Разумнее работать на более дешёвой модели и переключаться на Fable для отдельных задач.

Сколько стоит запрос к Fable 5.1

Формула без кэша:

Пример: запрос на 20 000 входных токенов и 2 000 выходных.

• вход: 20 000 × 3.48 / 1 000 000 = $0.0696
• выход: 2 000 × 17.4 / 1 000 000 = $0.0348
• итого: $0.1044 за запрос, или $104.40 за 1 000 таких запросов

Тот же объём на Claude Opus 5.5: 20 000 × 0.4 / 1 000 000 + 2 000 × 2 / 1 000 000 = $0.008 + $0.004 = $0.012 за запрос, $12.00 за 1 000.

Выход у Fable стоит в пять раз дороже входа (17.4 против 3.48), поэтому длинные ответы бьют по бюджету сильнее длинных промптов. Параметр max_tokens задаёт верхнюю границу: при max_tokens=4000 выход одного запроса обойдётся не дороже 4 000 × 17.4 / 1 000 000 = $0.0696.

Кэш: где он реально меняет счёт

С кэшем формула такая: свежий вход × цена входа + чтение кэша × цена чтения + запись кэша × цена записи + выход × цена выхода.

Возьмём шаг агента с контекстом 100 000 токенов, из которых 90 000 уже лежат в кэше, 10 000 — новые, ответ — 2 000 токенов:

• свежий вход: 10 000 × 3.48 = 34 800
• чтение кэша: 90 000 × 0.3 = 27 000
• выход: 2 000 × 17.4 = 34 800
• итого: 96 600 / 1 000 000 = $0.0966

Тот же шаг без кэша (например, через OpenAI-формат): 100 000 × 3.48 + 2 000 × 17.4 = 382 800 → $0.3828.

Первый шаг дороже обычного: 90 000 токенов записываются в кэш по $3.663, то есть 90 000 × 3.663 / 1 000 000 = $0.3297, плюс $0.0348 за свежий вход и $0.0348 за выход — всего $0.3993. Кэш окупается со второго обращения к тому же префиксу. Если контекст каждый раз новый, кэш не поможет, а запись только добавит расходов.

Когда Fable 5.1 оправдана

Данных о том, в чём Fable 5.1 сильнее других моделей на конкретных задачах, у нас нет, и придумывать их мы не будем. Практические критерии такие:

• Вы проверили на своих задачах. Прогнали 20–50 реальных примеров через Fable 5.1, Opus 5.5 и GPT-6 Astra, и Fable даёт заметно лучший результат именно у вас.
• Объём маленький, цена ошибки высокая. Десяток запросов в день, где неудачный ответ стоит дороже, чем $0.10 за запрос.
• Длинный контекст переиспользуется. Много вопросов к одному большому документу через Anthropic-формат — тогда большая часть входа идёт по цене чтения кэша.

Плохие сценарии: массовая обработка, чат-бот с большим трафиком, длинные агентные сессии без кэша. Для них посмотрите модели подешевле, сравнивая индекс силы и цену.

Как ограничить расход: лимит ключа и allowed_models

Дорогую модель лучше изолировать настройками ключа. В Zukko у каждого ключа есть имя, дневной и месячный лимит в долларах и список разрешённых моделей allowed_models. Всё это задаётся на странице «API-ключи» в кабинете.

Рабочая схема:

1. Отдельный ключ для Fable. Например, fable-research с allowed_models = только claude-fable-5-1, с дневным лимитом $5 и месячным $50. Лимит ограничит расход по этому ключу, даже если скрипт зациклится.
2. Основной ключ без Fable. В allowed_models основного ключа перечислите только рабочие модели. Если кто-то в коде или в настройках IDE поставит claude-fable-5-1, запрос получит ошибку 403 model_not_allowed_for_key, а не спишет деньги.
3. max_tokens в каждом запросе. Ограничивает самую дорогую часть — выход.
4. Проверка расхода. История списаний — в разделе «Использование» кабинета и через API. Если баланса не хватит, запрос получит 402.

Подробности о лимитах — в документации по лимитам ключей и кэшу↗ и в статье про allowed_models↗.

Если хотите попробовать Fable 5.1 на своих задачах, создайте отдельный ключ с лимитом в кабинете и подключите его по примерам выше.

Частые вопросы

Почему Fable 5.1 дороже Opus 5.5, если индекс у неё ниже?

Цена и индекс силы не связаны напрямую: у каждой модели своя цена, а индекс — усреднённый балл по набору бенчмарков. По цифрам каталога Opus 5.5 и дешевле, и выше по индексу. Fable имеет смысл, только если на ваших задачах она показывает лучший результат. Подробный расчёт — в статье Claude Fable 5.1 или Opus 5.5↗.

Можно ли вызывать Fable 5.1 через OpenAI SDK?

Да, через https://api.zukko.pro/v1. Но скидки за кэш в этом формате для Claude-моделей нет: весь вход идёт по $3.48 за 1M. Для длинных повторяющихся контекстов используйте Anthropic-формат.

Принимает ли Fable 5.1 картинки и какой у неё контекст?

По каталогу — да, картинки на вход поддерживаются, контекст 1M токенов. Учтите, что изображения тоже превращаются во входные токены и оплачиваются по цене входа.

Как не дать агенту случайно перейти на Fable?

Не включайте claude-fable-5-1 в allowed_models ключа, который использует агент. Тогда запрос к ней вернёт 403 model_not_allowed_for_key.