Семейство Claude

Модели Claude от Anthropic: серии Opus, Sonnet, Haiku и Fable. Рекомендуется вызывать их через нативный API Anthropic — расширенный thinking, кэширование промптов, ввод PDF и другие возможности работают так же, как в официальном API. OpenAI-совместимый API тоже доступен и подходит для проектов, где уже используется OpenAI SDK.

Типичные задачи

Включить расширенный thinking thinking, budget_tokens, adaptive и как прочитать содержимое thinking.Кэширование промптов cache_control, кэш на 1 час, как проверить попадание в кэш.Веб-поиск Инструмент web_search; требуется указать провайдера Anthropic.Длинный контекст и PDF Контекст 1M, загрузка PDF-документов.Разбор ошибок prompt is too long, модель не найдена, обрезанный ответ.Использование в Claude Code Настройка подключения и частые вопросы.

Модели

Все модели принимают на вход текст, изображения и PDF и поддерживают вызов инструментов. Полный список моделей и актуальные цены см. на странице моделей ; их также можно получить через Models API.

Основные ID моделей (копируйте без изменений)

Claude Opus 5.5anthropic/claude-opus-5.5

Claude Sonnet 5.5anthropic/claude-sonnet-5.5

Claude Haiku 5.5anthropic/claude-haiku-5.5

Claude Fable 5.1anthropic/claude-fable-5.1

Префикс anthropic/ в ID модели можно опустить, а также можно использовать официальную запись Anthropic. Все варианты ниже указывают на одну и ту же модель:

Запись	Пример
Стандартная запись OfoxAI	`anthropic/claude-sonnet-4.6`
Без префикса	`claude-sonnet-4.6`
Официальная (через дефис)	`claude-sonnet-4-6`
Официальная с датой	`claude-sonnet-4-6-20260217`

Доступные псевдонимы каждой модели указаны в поле aliases ответа Models API. Поле model в ответе всегда содержит стандартную запись.

Выбор API

ГлавноеДля расширенного thinking, кэширования промптов и инструментов вроде Claude Code используйте нативный API Anthropic.

	Нативный API Anthropic (рекомендуется)	OpenAI-совместимый API
Адрес	`POST https://api.ofox.io/anthropic/v1/messages`	`POST https://api.ofox.io/v1/chat/completions`
`base_url` в SDK	`https://api.ofox.io/anthropic`	`https://api.ofox.io/v1`
Аутентификация	`x-api-key: <Key>`; также принимается `Authorization: Bearer <Key>`	`Authorization: Bearer <Key>`
Расширенный thinking	Параметр `thinking`, возвращаются блоки `thinking`	Параметр `reasoning`, возвращается `reasoning_details`
Кэширование промптов	`cache_control`; в usage возвращаются объёмы записи и чтения	`cache_control` в блоках содержимого сообщений; в usage возвращается только объём чтения
PDF	Блок содержимого `document`	Блок содержимого `file`
Веб-поиск	Поддерживается (требуется указать провайдера Anthropic)	Не поддерживается

Полный список параметров запроса см. в Anthropic Messages API и Chat Completions API.

Провайдеры

Модели Claude предоставляют два провайдера, и одна и та же модель поддерживает у них разный набор возможностей:

Провайдер	Модели	Доступные API	Примечание
Amazon Bedrock (`aws_bedrock`)	Все модели	Оба API	Провайдер по умолчанию
Anthropic (`anthropic`)	Fable 5, Opus 4.8, Opus 4.7, Sonnet 5	Только нативный API Anthropic	Поддерживает веб-поиск; нужно указывать явно

В нативном API Anthropic провайдера можно указать заголовком запроса:


-H "X-OfoxAI-Provider-Type: anthropic"

Если указанный провайдер не предоставляет эту модель, возвращается 400, а в сообщении об ошибке перечислены доступные провайдеры, например:


No available channel for platform 'anthropic' on model 'anthropic/claude-sonnet-4.6'. Available platforms for this model: aws_bedrock.

Другие способы указать провайдера: Маршрутизация провайдеров.

Примеры вызова

Python (Anthropic SDK)

claude_basic.py


import os
import anthropic
 
client = anthropic.Anthropic(
    base_url="https://api.ofox.io/anthropic",
    api_key=os.environ["OFOX_API_KEY"],
)
 
message = client.messages.create(
    model="anthropic/claude-sonnet-4.6",
    max_tokens=1024,
    system="Ты опытный бэкенд-инженер, отвечай кратко.",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое идемпотентность."}],
)
print(message.content[0].text)

cURL

Terminal


curl https://api.ofox.io/anthropic/v1/messages \
  -H "x-api-key: $OFOX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Объясни одним предложением, что такое идемпотентность."}]
  }'

Python (OpenAI SDK)

claude_openai_sdk.py


import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое идемпотентность."}],
)
print(resp.choices[0].message.content)

max_tokens — обязательный параметр нативного API Anthropic; его значение не должно превышать максимальный объём вывода модели.

Использование в Claude Code

Claude Code обращается к нативному API Anthropic, базовый адрес — https://api.ofox.io/anthropic. Порядок настройки см. в разделе Настройка Claude Code.

Значения для настройки Claude Code

ANTHROPIC_BASE_URLhttps://api.ofox.io/anthropic

ANTHROPIC_AUTH_TOKENВставьте ваш API-ключ OfoxAI

Типичные ошибки

ГлавноеОшибки в параметрах возвращают 400 с описанием причины; обрезанный ответ — это не ошибка, проверьте stop_reason.

HTTP · type	Текст ошибки	Причина	Решение
400 `ValidationException`	`prompt is too long: 280527 tokens > 200000 maximum`	Входные данные превышают контекст модели	Сократите входные данные или выберите модель с контекстом 1M (любую, кроме Haiku 4.5)
404 `model_not_found`	`Model 'anthropic/claude-sonnet-9' not found`	Ошибка в написании ID модели или модель снята с поддержки	Скопируйте ID модели с этой страницы
401 `invalid_api_key`	`Invalid or expired API key`	Неверный, удалённый или просроченный ключ	Проверьте ключ в консоли; для нативного API проверьте заголовок `x-api-key`
400	`No available channel for platform 'anthropic' on model ...`	Указанный провайдер не предоставляет эту модель	Удалите указание провайдера или выберите одного из провайдеров, перечисленных в сообщении об ошибке, — см. Провайдеры
200, `stop_reason: "max_tokens"`	—	Вывод достиг лимита `max_tokens`, ответ обрезан	Увеличьте `max_tokens`; при включённом thinking он тоже расходует этот лимит

Прочие общие ошибки: Обработка ошибок.

Официальная документация

Официальная документация описывает поведение при прямом обращении к Anthropic. При вызове через OfoxAI ID моделей и адреса API указывайте так, как описано на этой странице.

Часто задаваемые вопросы

Как записывать ID моделей Claude?

Стандартная запись — anthropic/claude-sonnet-4.6. Можно опустить префикс anthropic/ или использовать официальные записи claude-sonnet-4-6 и claude-sonnet-4-6-20260217 — все они указывают на одну и ту же модель.

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

Да. Укажите base_url https://api.ofox.io/v1 и ID модели, например anthropic/claude-sonnet-4.6. Если нужен расширенный thinking или полные данные об использовании кэша, рекомендуется нативный API Anthropic.

Как включить у Claude режим thinking?

В нативном API передайте thinking: {"type": "enabled", "budget_tokens": 2000}; budget_tokens должен быть не меньше 1024 и меньше max_tokens. Либо передайте {"type": "adaptive"}, и модель решит сама. В OpenAI-совместимом API передайте reasoning: {"max_tokens": 2000}. При включённом thinking не задавайте temperature.

Что делать, если кэширование промптов Claude не срабатывает?

Проверьте по порядку: отмечен ли неизменный блок содержимого через cache_control (ни один из API не кэширует автоматически); достигает ли содержимое минимальной длины для кэширования; полностью ли совпадает префикс в двух запросах; не прошло ли между запросами больше 5 минут.

Что делать с ошибкой prompt is too long?

Входные данные превысили контекст модели. У Haiku 4.5 контекст 200K токенов, у остальных моделей Claude — 1M токенов. Выберите другую модель или сократите входные данные.

Поддерживает ли Claude контекст 1M? Нужен ли beta-заголовок?

Контекст 1M поддерживают все модели, кроме Haiku 4.5. В OfoxAI передавать beta-заголовок не нужно.

Что делать, если ответ Claude обрезан?

Проверьте stop_reason в ответе. Если там max_tokens, вывод достиг лимита — увеличьте max_tokens. При включённом thinking его содержимое тоже расходует лимит max_tokens.

Какой провайдер предоставляет Claude в OfoxAI?

Все модели предоставляет Amazon Bedrock — это провайдер по умолчанию. Для Fable 5, Opus 4.8, Opus 4.7 и Sonnet 5 есть также провайдер Anthropic: он работает только через нативный API Anthropic и указывается заголовком X-OfoxAI-Provider-Type: anthropic.

Может ли Claude искать в интернете?

Да, но нужно указать провайдера Anthropic. Это доступно только для Fable 5, Opus 4.8, Opus 4.7 и Sonnet 5 и только через нативный API Anthropic. Добавьте в tools {"type": "web_search_20250305", "name": "web_search"}.

Может ли Claude читать PDF?

Да. В нативном API передайте PDF в кодировке base64 в блоке содержимого document; в OpenAI-совместимом API используйте блок содержимого file, где file_data имеет формат data:application/pdf;base64,....